simvx.core.input.enums

Controller and pointer enumerations for the input system.

Keys, pointer and tablet buttons are not here: they are controls of a device type, which is :mod:simvx.core.input.controls.

Module Contents

Classes

InputMethod	What the player is using right now, for prompts and for on-screen controls.
ControllerSource	Where a pad in Input.controllers came from.
ControllerFamily	Which controller family a pad belongs to, which decides what a prompt draws.
MouseCaptureMode	Mouse cursor capture modes.
CursorShape	The shape of the operating system’s pointer over a control.
PointerType	What kind of pointer produced an event. A finger and a pen are pointers too.
PointerPhase	What a pointer did. The one spelling for a pointer edge.
PointerTool	Which working end of a pointer is making the contact.
PenAxis	A pen measurement the hardware can report, for Input.capabilities.pen_axes.
FocusMode	How a node takes keyboard focus. Each mode includes the ones before it.
FocusReason	Why keyboard focus last moved, which tree.focus_reason records with every change.

API

class simvx.core.input.enums.InputMethod

Bases: enum.StrEnum

What the player is using right now, for prompts and for on-screen controls.

Not what the machine has: Input.capabilities answers that. This is the one the player last acted with, so a game shows “Press A” while they hold a controller and “Press Space” the moment they touch the keyboard.

Initialization

Initialize self. See help(type(self)) for accurate signature.

KEYBOARD_MOUSE

‘keyboard_mouse’

CONTROLLER

‘controller’

TOUCH

‘touch’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.ControllerSource

Bases: enum.StrEnum

Where a pad in Input.controllers came from.

A lobby that wants only real controllers filters on this; everything else treats the three alike, which is the point of the on-screen pad being a pad.

Initialization

Initialize self. See help(type(self)) for accurate signature.

DEVICE

‘device’

SIMULATED

‘simulated’

VIRTUAL

‘virtual’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.ControllerFamily

Bases: enum.StrEnum

Which controller family a pad belongs to, which decides what a prompt draws.

A pad’s controls are positional on every family, so Controller.A is the bottom face button whichever pad is plugged in; only the label printed on it moves.

Initialization

Initialize self. See help(type(self)) for accurate signature.

XBOX

‘xbox’

PLAYSTATION

‘playstation’

NINTENDO

‘nintendo’

GENERIC

‘generic’

JOYSTICK

‘joystick’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.MouseCaptureMode

Bases: enum.IntEnum

Mouse cursor capture modes.

Initialization

Initialize self. See help(type(self)) for accurate signature.

VISIBLE

0

HIDDEN

1

CAPTURED

2

CONFINED

3

__abs__()

__add__()

__and__()

__bool__()

__ceil__()

__delattr__()

__dir__()

__divmod__()

__eq__()

__float__()

__floor__()

__floordiv__()

__format__()

__ge__()

__getattribute__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__index__()

__int__()

__invert__()

__le__()

__lshift__()

__lt__()

__mod__()

__mul__()

__ne__()

__neg__()

__new__()

__or__()

__pos__()

__pow__()

__radd__()

__rand__()

__rdivmod__()

__reduce__()

__reduce_ex__()

__repr__()

__rfloordiv__()

__rlshift__()

__rmod__()

__rmul__()

__ror__()

__round__()

__rpow__()

__rrshift__()

__rshift__()

__rsub__()

__rtruediv__()

__rxor__()

__setattr__()

__sizeof__()

__str__()

__sub__()

__subclasshook__()

__truediv__()

__trunc__()

__xor__()

as_integer_ratio()

bit_count()

bit_length()

conjugate()

class denominator

class imag

is_integer()

class numerator

class real

to_bytes()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.CursorShape

Bases: enum.StrEnum

The shape of the operating system’s pointer over a control.

Each maps to the platform’s own cursor of that name, and to the CSS cursor of the same meaning in the browser. A backend without one shows ARROW.

Initialization

Initialize self. See help(type(self)) for accurate signature.

ARROW

‘arrow’

IBEAM

‘ibeam’

CROSSHAIR

‘crosshair’

POINTING_HAND

‘pointing_hand’

RESIZE_EW

‘resize_ew’

RESIZE_NS

‘resize_ns’

RESIZE_NWSE

‘resize_nwse’

RESIZE_NESW

‘resize_nesw’

MOVE

‘move’

NOT_ALLOWED

‘not_allowed’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.PointerType

Bases: enum.StrEnum

What kind of pointer produced an event. A finger and a pen are pointers too.

Initialization

Initialize self. See help(type(self)) for accurate signature.

MOUSE

‘mouse’

TOUCH

‘touch’

PEN

‘pen’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.PointerPhase

Bases: enum.StrEnum

What a pointer did. The one spelling for a pointer edge.

Initialization

Initialize self. See help(type(self)) for accurate signature.

DOWN

‘down’

MOVE

‘move’

UP

‘up’

CANCEL

‘cancel’

ENTER

‘enter’

LEAVE

‘leave’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.PointerTool

Bases: enum.StrEnum

Which working end of a pointer is making the contact.

A mouse and a finger report TIP: the contact they make is their only one. A pen reports the end it is using, which is how an eraser is told from the tip on every platform, whether the platform calls it a tool, a flag or a second device. A change of tool closes the current contact and opens a new one, so a handler never sees the tool change inside a stroke.

Initialization

Initialize self. See help(type(self)) for accurate signature.

TIP

‘tip’

ERASER

‘eraser’

AIRBRUSH

‘airbrush’

PUCK

‘puck’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.PenAxis

Bases: enum.StrEnum

A pen measurement the hardware can report, for Input.capabilities.pen_axes.

Each is an axis whose absent value collides with a real one, so whether it was measured is a capability rather than a magic number: a brush panel greys out the sliders the artist’s pen cannot drive.

Initialization

Initialize self. See help(type(self)) for accurate signature.

PRESSURE

‘pressure’

TILT

‘tilt’

TWIST

‘twist’

DISTANCE

‘distance’

TANGENTIAL

‘tangential’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.FocusMode

Bases: enum.StrEnum

How a node takes keyboard focus. Each mode includes the ones before it.

Members: NONE: Never holds focus. CLICK: Takes focus when pressed, and from code; not a Tab stop. ALL: Also a Tab stop and a directional-focus destination. HOVER: Also takes focus when the mouse or pen comes to rest over it, under the rules :class:~simvx.core.ui.ui_input.UIInputManager applies to hover focus. A finger never moves focus by hovering.

A property takes the member or its plain string: focus_mode = "all".

Initialization

Initialize self. See help(type(self)) for accurate signature.

NONE

‘none’

CLICK

‘click’

ALL

‘all’

HOVER

‘hover’

property takes_focus: bool

Whether a node in this mode can hold focus at all.

property in_tab_order: bool

Whether Tab and directional focus reach a node in this mode.

property follows_hover: bool

Whether the pointer resting over a node in this mode focuses it.

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()

class simvx.core.input.enums.FocusReason

Bases: enum.StrEnum

Why keyboard focus last moved, which tree.focus_reason records with every change.

A widget that draws a focus ring only for the keyboard, or a tutorial that reacts to the player reaching a button, reads it rather than guessing.

Initialization

Initialize self. See help(type(self)) for accurate signature.

CODE

‘code’

CLICK

‘click’

TAB

‘tab’

DIRECTION

‘direction’

HOVER

‘hover’

OVERLAY

‘overlay’

LEFT

‘left’

__new__(*values)

__add__()

__contains__()

__delattr__()

__dir__()

__eq__()

__format__()

__ge__()

__getattribute__()

__getitem__()

__getnewargs__()

__getstate__()

__gt__()

__hash__()

__iter__()

__le__()

__len__()

__lt__()

__mod__()

__mul__()

__ne__()

__reduce__()

__reduce_ex__()

__repr__()

__rmod__()

__rmul__()

__setattr__()

__sizeof__()

__str__()

__subclasshook__()

capitalize()

casefold()

center()

count()

encode()

endswith()

expandtabs()

find()

format()

format_map()

index()

isalnum()

isalpha()

isascii()

isdecimal()

isdigit()

isidentifier()

islower()

isnumeric()

isprintable()

isspace()

istitle()

isupper()

join()

ljust()

lower()

lstrip()

partition()

removeprefix()

removesuffix()

replace()

rfind()

rindex()

rjust()

rpartition()

rsplit()

rstrip()

split()

splitlines()

startswith()

strip()

swapcase()

title()

translate()

upper()

zfill()

__deepcopy__(memo)

__copy__()

name()

value()