+ ics$Rt^RIHt^RIt^RIHtHtHtHtH t ^RI t ^RI H t H t ^RIHt^RIHt^RIHt^RIHt^R IHt!R R ]4t!R R ]4t!RR]4t!RR]4t!RR]P84t!RR4tR#)a&Provides protocols for mapping handlers *** The architecture behind mapping handlers *** Handling an InputEvent is done in 3 steps: 1. Input Event Handling A MappingHandler that does Input event handling receives Input Events directly from the EventReader. To do so it must implement the InputEventHandler protocol. An InputEventHandler may handle multiple events (InputEvent.type_and_code) 2. Event Transformation The event gets transformed as described by the mapping. e.g.: combining multiple events to a single one transforming EV_ABS to EV_REL macros ... Multiple transformations may get chained 3. Event Injection The transformed event gets injected to a global_uinput MappingHandlers can implement one or more of these steps. Overview of implemented handlers and the steps they implement: Step 1: - HierarchyHandler Step 1 and 2: - CombinationHandler - AbsToBtnHandler - RelToBtnHandler Step 1, 2 and 3: - AbsToRelHandler - NullHandler Step 2 and 3: - KeyHandler - MacroHandler ) annotationsN)DictProtocolSetOptionalList)InputCombination InputConfig)Mapping)MappingParsingError) GlobalUInputs) InputEvent)loggercs"]tRt^LtRRltRtR#) EventListenerc V^8dQhRRRR/#)eventzevdev.InputEventreturnNoneZformat"]/usr/lib/python3.14/site-packages/inputremapper/injection/mapping_handlers/mapping_handler.py __annotate__ZEventListener.__annotate__MsBB$4BBc s"R#5iNr)selfr&&r__call__ZEventListener.__call__MsssrN)__name__ __module__ __qualname____firstlineno__r__static_attributes__rrrr r LsBBrr cs2]tRt^Pt$RtR]R&RRltRtR#)ContextProtocolz+The parts from context needed for handlers.zSet[EventListener]Z listenerscV^8dQhRR/#)rrz evdev.UInputrrrrrZContextProtocol.__annotate__Us   rc R#rr)rZ origin_hashrrget_forward_uinputZ"ContextProtocol.get_forward_uinputUs rrN)rrrr __doc____annotations__r%r!rrrr"r"Ps5!!  rr"cs*]tRt^YtRtRRRlltRtR#)NotifyCallbackz`Type signature of InputEventHandler.notify return True if the event was actually taken care of c(V^8dQhRRRRRRRR/#rrr sourcezevdev.InputDevicesuppressboolrrrrrrZNotifyCallback.__annotate___2"   rc r$rrrrr+r,&&&&rrZNotifyCallback.__call___ rrNF)rrrr r&rr!rrrr(r(Ys rr(cs6]tRt^gtRtRRRlltRRltRtR#) InputEventHandlerzNThe protocol any handler, which can be part of an event pipeline, must follow.cr)r*rrrrrInputEventHandler.__annotate__jr.rc r$rrr/r0rnotifyZInputEventHandler.notifyjr1rcr#rrrrrrrrr4qs  t rc R#)8Reset the state of the handler e.g. release any buttons.Nrr&rresetZInputEventHandler.resetqs rrNr2)rrrr r&r5r;r!rrrr3r3gsX  rr3cs]tRt^vt]P !4t]P !4t]P !4t]P !4t ]P !4t ]P !4t ]P !4t ]P !4t ]P !4t]P !4t]P !4t]P !4t]P !4t]P !4tRtR#) HandlerEnumsrN)rrrr enumZautoZabs2btnZrel2btnZmacroZkeyZbtn2relZrel2relZabs2relZbtn2absZrel2absZabs2abs combinationZ hierarchyZ axisswitchZdisabler!rrrr<r<vsiikGiikG IIKE ))+CiikGiikGiikGiikGiikGiikG))+K IJiikGrr<cs]tRt^t$RtR]R&R]R&R]R&RR ltRR R lltR R ltRRlt RRlt RRlt RRlt RRlt RRltRtR#)MappingHandlerzThe protocol an InputEventHandler must follow if it should be dynamically integrated in an event-pipeline by the mapping parser rmappingzList[InputConfig] input_configszOptional[InputEventHandler] _sub_handlercs(V^8dQhRRRRRRRR/#) rr>rr@rglobal_uinputsr rrrrrrrMappingHandler.__annotate__s2--%--& -  -rc sLW n\V4VnRVnW0nR#)zsInitialize the handler Parameters ---------- combination the combination from sub_handler.wrap_with() mapping N)r@ZlistrArBrC)rr>r@rCZ_s&&&&,r__init__ZMappingHandler.__init__s$ !+. ,rcr)r*rrrrrrDs2""""" "  "rc \h)zNotify this handler about an incoming event. Parameters ---------- event The newest event that came from `source`, and that should be mapped to something else source Where `event` comes from ZNotImplementedErrorr/r0rr5ZMappingHandler.notifys "!rcr#r6rrrrrrDs""t"rc rF)r8rGr9r:rr;ZMappingHandler.resets!!rcr#rrr-rrrrrrDs)))rc s:\VP44^8#)z>If this handler needs to be wrapped in another MappingHandler.)Zlen wrap_withr9r:rneeds_wrappingZMappingHandler.needs_wrappings4>>#$q((rcr#rHrrrrrrDstrc r7)zCIf this handler needs ranking and wrapping with a HierarchyHandler.Frr9r:r needs_rankingZMappingHandler.needs_rankingsrcr#)rrzOptional[InputCombination]rrrrrrDsDD3Drc r7)z5The combination for which this handler needs ranking.Nrr9r:rrank_byZMappingHandler.rank_bysrcr#)rrz$Dict[InputCombination, HandlerEnums]rrrrrrDs?rc s/#)zA dict of InputCombination -> HandlerEnums. for each InputCombination this handler should be wrapped with the given MappingHandler. rr9r:rrIZMappingHandler.wrap_withs  rcr)rhandlerr3rrrrrrrrDs$$'8$T$rc sWnR#)z Give this handler a sub_handler.N)rB)rrMrrset_sub_handlerZMappingHandler.set_sub_handlers#rcr)r input_configrrrrrrrrrDs 0 0 0 0rc sVP'g$\P!V4\RVR7hVPP V4R#)z*Remove the config from self.input_configs.z#Cannot remove a non existing config)Zmapping_handlerN)rAr Zdebug_mapping_handlerr Zremove)rrOrrocclude_input_eventZ"MappingHandler.occlude_input_eventsD!!!  ( ( .%5t  !!,/r)rBrCrAr@Nr2)rrrr r&r'rEr5r;rJrKrLrIrNrPr!rrrr?r?sP%$---("$")D$ 0 0rr?)r&Z __future__rr=ZtypingrrrrrZevdevZ"inputremapper.configs.input_configrrZinputremapper.configs.mappingrZinputremapper.exceptionsr Z&inputremapper.injection.global_uinputsr Zinputremapper.input_eventr Zinputremapper.logging.loggerr r r"r(r3ZEnumr<r?rrrrQs|&)T# 66 L18@0/CHC h  X     4990W0W0r