\ jZfdZddlZddlmZeedoejZGddeZGddeZ Gd d eZ Gd d Z Gd deZ e dGdde ZGdde ZGdde Ze de dGddeZe de de de dGddeZe d e d!Gd"d#ZGd$d%eZe d&e d'e d(Gd)d*ZdS)+z=Interface classes for `pyglet.input`. .. versionadded:: 1.2 N)EventDispatcheris_pyglet_doc_runceZdZdS)DeviceExceptionN__name__ __module__ __qualname__K/DATA/AppData/hermes/venv/lib/python3.11/site-packages/pyglet/input/base.pyrr0Dr rceZdZdS)DeviceOpenExceptionNrr r r rr4rr rceZdZdS)DeviceExclusiveExceptionNrr r r rr8rr rc2eZdZdZdZd dZdZdZdZdS) Devicea\Input device. :Ivariables: display : `pyglet.canvas.Display` Display this device is connected to. name : str Name of the device, as described by the device firmware. manufacturer : str Name of the device manufacturer, or ``None`` if the information is not available. c>||_||_d|_d|_dSNF)displayname manufactureris_open)selfrrs r __init__zDevice.__init__Is%    r NFc@|jrtdd|_dS)aOpen the device to begin receiving input from it. :Parameters: `window` : Window Optional window to associate with the device. The behaviour of this parameter is device and operating system dependant. It can usually be omitted for most devices. `exclusive` : bool If ``True`` the device will be opened exclusively so that no other application can use it. The method will raise `DeviceExclusiveException` if the device cannot be opened this way (for example, because another application has already opened it). zDevice is already open.TN)rrrwindow exclusives r openz Device.openQs) < A%&?@@ @ r cd|_dS)zClose the device. FN)rrs r closez Device.closefs  r c td)zZGet a list of controls provided by the device. :rtype: list of `Control` abstractNotImplementedErrorr#s r get_controlszDevice.get_controlsjs "*---r c0|jjd|jdS)N(name=) __class__rrr#s r __repr__zDevice.__repr__qs $ 7 7 7CCr r) rr r __doc__rr!r$r)r/r r r rr<ss  *...DDDDDr rcdeZdZdZddZedZejdZdZe rdZ dSdS) ControlaSingle value input provided by a device. A control's value can be queried when the device is open. Event handlers can be attached to the control to be called when the value changes. The `min` and `max` properties are provided as advertised by the device; in some cases the control's value will be outside this range. :Ivariables: `name` : str Name of the control, or ``None`` if unknown `raw_name` : str Unmodified name of the control, as presented by the operating system; or ``None`` if unknown. `inverted` : bool If ``True``, the value reported is actually inverted from what the device reported; usually this is to provide consistency across operating systems. Nc>||_||_d|_d|_dSr)rraw_nameinverted_value)rrr4s r rzControl.__init__s"     r c|jS)aCurrent value of the control. The range of the value is device-dependent; for absolute controls the range is given by ``min`` and ``max`` (however the value may exceed this range); for relative controls the range is undefined. :type: float r6r#s r valuez Control.values {r cZ||jkrdS||_|d|dSN on_changer6dispatch_eventrnewvalues r r9z Control.values7 t{ " " F  K22222r c||jr|jjd|jd|jdS|jjd|jdS)Nr+z , raw_name=r,z (raw_name=)rr.rr4r#s r r/zControl.__repr__sU 9 P'''DMMMC C)-(?(?(?O Or cdS)zThe value changed. :Parameters: `value` : float Current value of the control. :event: Nr )rr9s r r<zControl.on_changer N) rr r r0rpropertyr9setterr/_is_pyglet_doc_runr<r r r r2r2us(   X  \33\3 PPP        r r2r<cdeZdZdZdZdZdZdZdZdZ dZ e d Z e j d Z d S) RelativeAxiszRAn axis whose value represents a relative change from the previous value. xyzrxryrzwheelc|jSrDr8r#s r r9zRelativeAxis.values {r c@||_|d|dSr;r=r?s r r9zRelativeAxis.values%  K22222r N)rr r r0XYZRXRYRZWHEELrEr9rFr r r rIrIsy A A A B B B E X \33\333r rIcHeZdZdZdZdZdZdZdZdZ dZ d Z d Z d fd Z xZS) AbsoluteAxisaAn axis whose value represents a physical measurement from the device. The value is advertised to range over ``min`` and ``max``. :Ivariables: `min` : float Minimum advertised value. `max` : float Maximum advertised value. rJrKrLrMrNrOhathat_xhat_yNcvtt|||||_||_dSrD)superr[rminmax)rrrarbr4r.s r rzAbsoluteAxis.__init__s5 lD!!**4:::r rD)rr r r0rSrTrUrVrWrXHATHAT_XHAT_Yr __classcell__)r.s@r r[r[s|   A A A B B B C E Er r[c\eZdZdZedZejdZerdZdZ dSdS)Buttonz"A control whose value is boolean. c*t|jSrD)boolr6r#s r r9z Button.valuesDK   r c||jkrdS||_|dt||r|ddS|ddS)Nr<on_press on_release)r6r>rjr?s r r9z Button.valuess t{ " " F  Kh888  .    + + + + +    - - - - -r cdS)z9The button was pressed. :event: Nr r#s r rlzButton.on_pressrCr cdS)z:The button was released. :event: Nr r#s r rmzButton.on_releaserCr N) rr r r0rEr9rFrGrlrmr r r rhrhs,, !!X! \..\.            r rhrlrmc>eZdZdZdZd dZdZdZdZd Z d Z dS) Joysticka<High-level interface for joystick-like devices. This includes analogue and digital joysticks, gamepads, game controllers, and possibly even steering wheels and other input devices. There is unfortunately no way to distinguish between these different device types. To use a joystick, first call `open`, then in your game loop examine the values of `x`, `y`, and so on. These values are normalized to the range [-1.0, 1.0]. To receive events when the value of an axis changes, attach an on_joyaxis_motion event handler to the joystick. The :py:class:`~pyglet.input.Joystick` instance, axis name, and current value are passed as parameters to this event. To handle button events, you should attach on_joybutton_press and on_joy_button_release event handlers to the joystick. Both the :py:class:`~pyglet.input.Joystick` instance and the index of the changed button are passed as parameters to these events. Alternately, you may attach event handlers to each individual button in `button_controls` to receive on_press or on_release events. To use the hat switch, attach an on_joyhat_motion event handler to the joystick. The handler will be called with both the hat_x and hat_y values whenever the value of the hat switch changes. The device name can be queried to get the name of the joystick. :Ivariables: `device` : `Device` The underlying device used by this joystick interface. `x` : float Current X (horizontal) value ranging from -1.0 (left) to 1.0 (right). `y` : float Current y (vertical) value ranging from -1.0 (top) to 1.0 (bottom). `z` : float Current Z value ranging from -1.0 to 1.0. On joysticks the Z value is usually the throttle control. On game controllers the Z value is usually the secondary thumb vertical axis. `rx` : float Current rotational X value ranging from -1.0 to 1.0. `ry` : float Current rotational Y value ranging from -1.0 to 1.0. `rz` : float Current rotational Z value ranging from -1.0 to 1.0. On joysticks the RZ value is usually the twist of the stick. On game controllers the RZ value is usually the secondary thumb horizontal axis. `hat_x` : int Current hat (POV) horizontal position; one of -1 (left), 0 (centered) or 1 (right). `hat_y` : int Current hat (POV) vertical position; one of -1 (bottom), 0 (centered) or 1 (top). `buttons` : list of bool List of boolean values representing current states of the buttons. These are in order, so that button 1 has value at ``buttons[0]``, and so on. `x_control` : `AbsoluteAxis` Underlying control for `x` value, or ``None`` if not available. `y_control` : `AbsoluteAxis` Underlying control for `y` value, or ``None`` if not available. `z_control` : `AbsoluteAxis` Underlying control for `z` value, or ``None`` if not available. `rx_control` : `AbsoluteAxis` Underlying control for `rx` value, or ``None`` if not available. `ry_control` : `AbsoluteAxis` Underlying control for `ry` value, or ``None`` if not available. `rz_control` : `AbsoluteAxis` Underlying control for `rz` value, or ``None`` if not available. `hat_x_control` : `AbsoluteAxis` Underlying control for `hat_x` value, or ``None`` if not available. `hat_y_control` : `AbsoluteAxis` Underlying control for `hat_y` value, or ``None`` if not available. `button_controls` : list of `Button` Underlying controls for `buttons` values. c |_d_d_d_d_d_d_d_d_g_ d_ d_ d_ d_ d_d_d_d_g_fd}fd}fd}|D]c}t)|t*r,|jdvr ||,|jdkr ||Ct)|t.r ||ddS)Nrc|jd|j|jz z d|jzz |jr  t dz||jfd}dS)Ng@g_controlcj|zz}t|d|dS)Non_joyaxis_motion)setattrr>)r9normalized_valuebiasrscalers r r<z6Joystick.__init__..add_axis..on_changesG#(5=4#7 d$4555##$7tEUVVVVVr )rrbrar5rwevent)controlr<ryrrzrs @@@r add_axisz#Joystick.__init__..add_axiss.add_button..on_changes"' Qr c6ddS)Non_joybutton_pressr>rrsr rlz7Joystick.__init__..add_button..on_presss"##$8$BBBBBr c6ddS)Non_joybutton_releaserrsr rmz9Joystick.__init__..add_button..on_releases"##$:D!DDDDDr )lenrappendbutton_controlsr{)r|r<rlrmrrs @r add_buttonz%Joystick.__init__..add_buttonsDL!!A L   & & &  ' ' 0 0 0 ] ( ( ( ( (] (] C C C C C] C] E E E E E] E E Er cL__jfd}dS)Nc|dzdkrdx__nDjdkr|dz}d|cxkrdkrnnd|\__ndx__djjdS)Niri))r)rr)rr)r)rr)rr)rr)rron_joyhat_motion)r]r^rbr>)r9r|rs r r<z5Joystick.__init__..add_hat..on_changes6>V++.//DJ{Q%E~~~~A~~~~~2<=B2C. DJJ343 TZ##$6dj$*UUUUUr ) hat_x_control hat_y_controlr{)r|r<rs` r add_hatz"Joystick.__init__..add_hatsP!(D !(D  ] V V V V V] V V Vr )rJrKrLrMrNrOr]r^r\)devicerJrKrLrMrNrOr]r^r x_control y_control z_control rx_control ry_control rz_controlrrrr) isinstancer[rrh)rrr}rrr|s` r rzJoystick.__init__rs    !!! W W W W W E E E E E" V V V V V4**,, $ $G'<00 $<#VVVHW%%%%\U**GG$$$GV,, $ 7### $ $r NFc<|j||dS)z.Open the joystick device. See `Device.open`. Nrr!rs r r!z Joystick.open  +++++r c8|jdS)z0Close the joystick device. See `Device.close`. Nrr$r#s r r$zJoystick.close r cdS)aQThe value of a joystick axis changed. :Parameters: `joystick` : `Joystick` The joystick device whose axis changed. `axis` : string The name of the axis that changed. `value` : float The current value of the axis, normalized to [-1, 1]. Nr )rjoystickaxisr9s r rvzJoystick.on_joyaxis_motionrCr cdS)aA button on the joystick was pressed. :Parameters: `joystick` : `Joystick` The joystick device whose button was pressed. `button` : int The index (in `button_controls`) of the button that was pressed. Nr rrbuttons r rzJoystick.on_joybutton_pressrCr cdS)aA button on the joystick was released. :Parameters: `joystick` : `Joystick` The joystick device whose button was released. `button` : int The index (in `button_controls`) of the button that was released. Nr rs r rzJoystick.on_joybutton_releaserCr cdS)aThe value of the joystick hat switch changed. :Parameters: `joystick` : `Joystick` The joystick device whose hat control changed. `hat_x` : int Current hat (POV) horizontal position; one of -1 (left), 0 (centered) or 1 (right). `hat_y` : int Current hat (POV) vertical position; one of -1 (bottom), 0 (centered) or 1 (top). Nr )rrr]r^s r rzJoystick.on_joyhat_motionrCr r) rr r r0rr!r$rvrrrr r r rqrq"sMM^X$X$X$t,,,,                r rqrvrrrc2eZdZdZdZd dZdZdZdZdS) AppleRemoteaHigh-level interface for Apple remote control. This interface provides access to the 6 button controls on the remote. Pressing and holding certain buttons on the remote is interpreted as a separate control. :Ivariables: `device` : `Device` The underlying device used by this interface. `left_control` : `Button` Button control for the left (prev) button. `left_hold_control` : `Button` Button control for holding the left button (rewind). `right_control` : `Button` Button control for the right (next) button. `right_hold_control` : `Button` Button control for holding the right button (fast forward). `up_control` : `Button` Button control for the up (volume increase) button. `down_control` : `Button` Button control for the down (volume decrease) button. `select_control` : `Button` Button control for the select (play/pause) button. `select_hold_control` : `Button` Button control for holding the select button. `menu_control` : `Button` Button control for the menu button. `menu_hold_control` : `Button` Button control for holding the menu button. cvfd}|_|D]}|jdvr ||dS)Nctjdzjfd}jfd}dS)Nrtc>djdS)Non_button_pressr>rr|rsr rlz:AppleRemote.__init__..add_button..on_press,s"##$5w|DDDDDr c>djdS)Non_button_releaserrsr rmz.add_button..on_release0s"##$7FFFFFr )rwrr{)r|rlrmrs` r rz(AppleRemote.__init__..add_button)s D',3W = = = ] E E E E E] E] G G G G G] G G Gr ) left left_holdright right_holdupdownmenuselect menu_hold select_hold)rr)r)rrrr|s` r rzAppleRemote.__init__(sw G G G G G **,, $ $G| NNN 7### $ $r NFc<|j||dS)z%Open the device. See `Device.open`. Nrrs r r!zAppleRemote.open:rr c8|jdS)z'Close the device. See `Device.close`. Nrr#s r r$zAppleRemote.close>rr cdS)a_A button on the remote was pressed. Only the 'up' and 'down' buttons will generate an event when the button is first pressed. All other buttons on the remote will wait until the button is released and then send both the press and release events at the same time. :Parameters: `button` : unicode The name of the button that was pressed. The valid names are 'up', 'down', 'left', 'right', 'left_hold', 'right_hold', 'menu', 'menu_hold', 'select', and 'select_hold' :event: Nr rrs r rzAppleRemote.on_button_pressBrCr cdS)aA button on the remote was released. The 'select_hold' and 'menu_hold' button release events are sent immediately after the corresponding press events regardless of whether or not the user has released the button. :Parameters: `button` : unicode The name of the button that was released. The valid names are 'up', 'down', 'left', 'right', 'left_hold', 'right_hold', 'menu', 'menu_hold', 'select', and 'select_hold' :event: Nr rs r rzAppleRemote.on_button_releaseSrCr r) rr r r0rr!r$rrr r r rrsn>$$$$,,,,   "     r rrrceZdZdZdZdS)TabletaHigh-level interface to tablet devices. Unlike other devices, tablets must be opened for a specific window, and cannot be opened exclusively. The `open` method returns a `TabletCanvas` object, which supports the events provided by the tablet. Currently only one tablet device can be used, though it can be opened on multiple windows. If more than one tablet is connected, the behaviour is undefined. c td)zOpen a tablet device for a window. :Parameters: `window` : `Window` The window on which the tablet will be used. :rtype: `TabletCanvas` r&r'rrs r r!z Tablet.openss"*---r N)rr r r0r!r r r rrgs-   . . . . .r rc8eZdZdZdZdZer dZdZdZ dSdS) TabletCanvasa=Event dispatcher for tablets. Use `Tablet.open` to obtain this object for a particular tablet device and window. Events may be generated even if the tablet stylus is outside of the window; this is operating-system dependent. The events each provide the `TabletCursor` that was used to generate the event; for example, to distinguish between a stylus and an eraser. Only one cursor can be used at a time, otherwise the results are undefined. :Ivariables: `window` : Window The window on which this tablet was opened. c||_dSrD)rrs r rzTabletCanvas.__init__s  r c td)z1Close the tablet device for this window. r&r'r#s r r$zTabletCanvas.closes"*---r cdS)a1A cursor entered the proximity of the window. The cursor may be hovering above the tablet surface, but outside of the window bounds, or it may have entered the window bounds. Note that you cannot rely on `on_enter` and `on_leave` events to be generated in pairs; some events may be lost if the cursor was out of the window bounds at the time. :Parameters: `cursor` : `TabletCursor` The cursor that entered proximity. :event: Nr rcursors r on_enterzTabletCanvas.on_enterrCr cdS)a$A cursor left the proximity of the window. The cursor may have moved too high above the tablet surface to be detected, or it may have left the bounds of the window. Note that you cannot rely on `on_enter` and `on_leave` events to be generated in pairs; some events may be lost if the cursor was out of the window bounds at the time. :Parameters: `cursor` : `TabletCursor` The cursor that left proximity. :event: Nr rs r on_leavezTabletCanvas.on_leaverCr cdS)a0The cursor moved on the tablet surface. If `pressure` is 0, then the cursor is actually hovering above the tablet surface, not in contact. :Parameters: `cursor` : `TabletCursor` The cursor that moved. `x` : int The X position of the cursor, in window coordinates. `y` : int The Y position of the cursor, in window coordinates. `pressure` : float The pressure applied to the cursor, in range 0.0 (no pressure) to 1.0 (full pressure). `tilt_x` : float Currently undefined. `tilt_y` : float Currently undefined. :event: Nr )rrrJrKpressuretilt_xtilt_ys r on_motionzTabletCanvas.on_motionrCr N) rr r r0rr$rGrrrr r r rrs~  (... 7             C77r rrrrceZdZdZdZdZdS) TabletCursoraA distinct cursor used on a tablet. Most tablets support at least a *stylus* and an *erasor* cursor; this object is used to distinguish them when tablet events are generated. :Ivariables: `name` : str Name of the cursor. c||_dSrD)r)rrs r rzTabletCursor.__init__s  r c0|jjd|jdS)N(r,r-r#s r r/zTabletCursor.__repr__s>222DIII>>r N)rr r r0rr/r r r rrs<?????r r)r0sys pyglet.eventrhasattrrrG Exceptionrrrrr2register_event_typerIr[rhrqrrrrr r r rsH  ((((((WS"566P3;P     i        /           6D6D6D6D6D6D6D6Dr>>>>>o>>>@K(((333337333<&&&&&7&&&RW>:&&&<(((^ ^ ^ ^ ^ ^ ^ ^ @ 011112223444/000Y Y Y Y Y /Y Y Y v  1222  3444........0TTTTT?TTTl ,,, ,,, ---??????????r