# THIS FILE WAS AUTO-GENERATED BY ./commandsv2/generate_hids.py. DO NOT MODIFY
from typing import Optional, Union
from wpilib import EventLoop, LogitechF310Controller
from .commandgenerichid import CommandGenericHID
from .trigger import Trigger
[docs]
class CommandLogitechF310Controller:
"""
A version of :class:`wpilib.LogitechF310Controller` with :class:`.Trigger` factories for command-based.
"""
_hid: CommandGenericHID
_controller: LogitechF310Controller
def __init__(self, hid: Union[int, LogitechF310Controller]):
"""
Construct an instance of a controller.
:param hid: The port index on the Driver Station that the controller is plugged into,
or the LogitechF310Controller object to use for this controller.
"""
if isinstance(hid, int):
self._hid = CommandGenericHID.get_command_generic_hid(hid)
self._controller = LogitechF310Controller(self._hid.get_hid())
else:
self._hid = CommandGenericHID(hid.get_hid())
self._controller = hid
[docs]
def get_hid(self) -> CommandGenericHID:
"""
Get the underlying CommandGenericHID object.
:returns: the wrapped CommandGenericHID object
"""
return self._hid
[docs]
def get_controller(self) -> LogitechF310Controller:
"""
Get the wrapped controller object.
:returns: the wrapped controller object
"""
return self._controller
[docs]
def a(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the A button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the A button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.A, loop)
[docs]
def b(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the B button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the B button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.B, loop)
[docs]
def x(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the X button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the X button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.X, loop)
[docs]
def y(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Y button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Y button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.Y, loop)
[docs]
def back(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Back button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Back button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.BACK, loop)
[docs]
def logitech(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Logitech button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Logitech button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.LOGITECH, loop)
[docs]
def start(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Start button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Start button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.START, loop)
[docs]
def left_stick(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Left Stick button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Left Stick button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.LEFT_STICK, loop)
[docs]
def right_stick(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Right Stick button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Right Stick button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.RIGHT_STICK, loop)
[docs]
def left_bumper(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Left Bumper button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Left Bumper button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.LEFT_BUMPER, loop)
[docs]
def right_bumper(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Right Bumper button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Right Bumper button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.RIGHT_BUMPER, loop)
[docs]
def dpad_up(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Dpad Up button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Dpad Up button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.DPAD_UP, loop)
[docs]
def dpad_down(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Dpad Down button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Dpad Down button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.DPAD_DOWN, loop)
[docs]
def dpad_left(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Dpad Left button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Dpad Left button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.DPAD_LEFT, loop)
[docs]
def dpad_right(self, loop: Optional[EventLoop] = None) -> Trigger:
"""
Constructs a Trigger instance around the Dpad Right button's digital signal.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance representing the Dpad Right button's digital signal
attached to the given loop.
"""
return self.button(LogitechF310Controller.Button.DPAD_RIGHT, loop)
[docs]
def left_trigger(
self,
threshold: float = 0.5,
loop: Optional[EventLoop] = None,
) -> Trigger:
"""
Constructs a Trigger instance around the Left Trigger axis value. The returned
Trigger will be true when the axis value is greater than ``threshold``.
:param threshold: the minimum axis value for the returned Trigger to be true. This value
should be in the range [0, 1] where 0 is the unpressed state of the axis.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance that is true when the Left Trigger axis exceeds the
provided threshold, attached to the given event loop.
"""
return self.axis_greater_than(
LogitechF310Controller.Axis.LEFT_TRIGGER,
threshold,
loop,
)
[docs]
def right_trigger(
self,
threshold: float = 0.5,
loop: Optional[EventLoop] = None,
) -> Trigger:
"""
Constructs a Trigger instance around the Right Trigger axis value. The returned
Trigger will be true when the axis value is greater than ``threshold``.
:param threshold: the minimum axis value for the returned Trigger to be true. This value
should be in the range [0, 1] where 0 is the unpressed state of the axis.
:param loop: the event loop instance to attach the Trigger to, defaults
to :func:`commands2.CommandScheduler.get_default_button_loop`
:returns: a Trigger instance that is true when the Right Trigger axis exceeds the
provided threshold, attached to the given event loop.
"""
return self.axis_greater_than(
LogitechF310Controller.Axis.RIGHT_TRIGGER,
threshold,
loop,
)
[docs]
def axis_less_than(
self,
axis: LogitechF310Controller.Axis,
threshold: float,
loop: Optional[EventLoop] = None,
) -> Trigger:
"""
Constructs a Trigger instance that is true when the axis value is less than
``threshold``, attached to the given loop.
:param axis: the :class:`wpilib.LogitechF310Controller.Axis` to read
:param threshold: the value below which this Trigger should return true.
:param loop: the event loop instance to attach the Trigger to
:returns: a Trigger instance that is true when the axis value is less than
the provided threshold.
"""
return self._hid.axis_less_than(axis.value, threshold, loop)
[docs]
def axis_greater_than(
self,
axis: LogitechF310Controller.Axis,
threshold: float,
loop: Optional[EventLoop] = None,
) -> Trigger:
"""
Constructs a Trigger instance that is true when the axis value is greater
than ``threshold``, attached to the given loop.
:param axis: the :class:`wpilib.LogitechF310Controller.Axis` to read
:param threshold: the value above which this Trigger should return true.
:param loop: the event loop instance to attach the Trigger to.
:returns: a Trigger instance that is true when the axis value is greater
than the provided threshold.
"""
return self._hid.axis_greater_than(axis.value, threshold, loop)
[docs]
def axis_magnitude_greater_than(
self,
axis: LogitechF310Controller.Axis,
threshold: float,
loop: Optional[EventLoop] = None,
) -> Trigger:
"""
Constructs a Trigger instance that is true when the axis magnitude is
greater than ``threshold``, attached to the given loop.
:param axis: the :class:`wpilib.LogitechF310Controller.Axis` to read
:param threshold: the value above which this Trigger should return true.
:param loop: the event loop instance to attach the Trigger to.
:returns: a Trigger instance that is true when the axis magnitude is
greater than the provided threshold.
"""
return self._hid.axis_magnitude_greater_than(axis.value, threshold, loop)
[docs]
def get_axis(self, axis: LogitechF310Controller.Axis) -> float:
"""
Get the value of the axis.
:param axis: the :class:`wpilib.LogitechF310Controller.Axis` to read
"""
return self._hid.get_raw_axis(axis.value)
[docs]
def get_left_x(self) -> float:
"""
Get the Left X value of the controller.
:returns: the axis value.
"""
return self._controller.get_left_x()
[docs]
def get_left_y(self) -> float:
"""
Get the Left Y value of the controller.
:returns: the axis value.
"""
return self._controller.get_left_y()
[docs]
def get_right_x(self) -> float:
"""
Get the Right X value of the controller.
:returns: the axis value.
"""
return self._controller.get_right_x()
[docs]
def get_right_y(self) -> float:
"""
Get the Right Y value of the controller.
:returns: the axis value.
"""
return self._controller.get_right_y()
[docs]
def get_left_trigger(self) -> float:
"""
Get the Left Trigger value of the controller.
:returns: the axis value.
"""
return self._controller.get_left_trigger()
[docs]
def get_right_trigger(self) -> float:
"""
Get the Right Trigger value of the controller.
:returns: the axis value.
"""
return self._controller.get_right_trigger()