ó X–Tc @sdZddlZyddlZWnek rAddlZnXddlZddlZddlZddlZddl m Z d„Z da dadefd„ƒYZddd d d d d dddg ZdddddgZd„Zddd„Zddd„Zddddd„Zddddd„Zddddd„Zddddd„Zdd„Zdd„Zd „Zd!efd"„ƒYZd#efd$„ƒYZd%efd&„ƒYZd'efd(„ƒYZ d)efd*„ƒYZ!e!ƒZ"e ƒZ#dS(+sšThis module contains functions and classes for creating and issuing events. For a list of the events that are built into Spyral, check the :ref:`Event List`. .. attribute:: keys A special attribute for accessing the constants associated with a given key. For instance, ``spyral.keys.down`` and ``spyral.keys.f``. This is useful for testing for keyboard events. A complete list of all the key constants can be found in the :ref:`Keyboard Keys ` appendix. .. attribute:: mods A special attribute for accessing the constants associated with a given mod key. For instance, ``spyral.mods.lshift`` (left shift) and ``spyral.mods.ralt`` (Right alt). This is useful for testing for keyboard events. A complete list of all the key constants can be found in the :ref:`Keyboard Modifiers ` appendix. iÿÿÿÿN(t WeakMethodcCs'yt|ƒSWntk r"|SXdS(N(t_wmt TypeError(tfunc((s0/usr/lib/python2.7/site-packages/spyral/event.pyR#s tEventcBseZdZd„ZRS(s9 A class for building for attaching data to an event. Keyword arguments will be named attributes of the Event when it is passed into :func:`queue `:: collision_event = Event(ball=ball, paddle=paddle) spyral.event.queue("ball.collides.paddle", collision_event) cKs|jj|ƒdS(N(t__dict__tupdate(tselftkwargs((s0/usr/lib/python2.7/site-packages/spyral/event.pyt__init__5s(t__name__t __module__t__doc__R (((s0/usr/lib/python2.7/site-packages/spyral/event.pyR,stQUITt ACTIVEEVENTtKEYDOWNtKEYUPt MOUSEMOTIONt MOUSEBUTTONUPt VIDEORESIZEt VIDEOEXPOSEt USEREVENTtMOUSEBUTTONDOWNtlefttmiddletrightt scroll_upt scroll_downcCsÊi tƒtj6dtj6dtj6dtj6dtj6dtj6dtj6dtj 6tƒtj 6a i d tj6dtj6dtj6dtj6dtj6dtj6dtj6dtj 6dtj 6a dS(sp Initializes the Event system, which requires mapping the Pygame event constants to Spyral strings. tgaintstatetunicodetkeytmodtpostreltbuttonstbuttontsizetwths system.quitssystem.focus_changesinput.keyboard.downsinput.keyboard.upsinput.mouse.motionsinput.mouse.upsinput.mouse.downssystem.video_resizessystem.video_exposeN(Rsstate(sunicodeskeysmod(skeysmod(spossrelsbuttons(spossbutton(spossbutton(ssizeR&R'( ttupletpygameR RRRRRRRRt_TYPE_TO_ATTRSt _TYPE_TO_TYPE(((s0/usr/lib/python2.7/site-packages/spyral/event.pyt_init>s(                cCs/|dkrtjƒ}n|j||ƒdS(s9 Queues a new event in the system, meaning that it will be run at the next available opportunity. :param str event_name: The type of event (e.g., ``"system.quit"``, ``"input.mouse.up"``, or ``"pong.score"``. :param event: An Event object that holds properties for the event. :type event: :class:`Event ` :param scene: The scene to queue this event on; if `None` is given, the currently executing scene will be used. :type scene: :class:`Scene ` or `None`. N(tNonetspyralt_get_executing_scenet _queue_event(t event_nameteventtscene((s0/usr/lib/python2.7/site-packages/spyral/event.pytqueue]s cCs/|dkrtjƒ}n|j||ƒdS(st Instructs spyral to execute the handlers for this event right now. When you have a custom event, this is the function you call to have the event occur. :param str event_name: The type of event (e.g., ``"system.quit"``, ``"input.mouse.up"``, or ``"pong.score"``. :param event: An Event object that holds properties for the event. :type event: :class:`Event ` :param scene: The scene to queue this event on; if ``None`` is given, the currently executing scene will be used. :type scene: :class:`Scene ` or ``None``. N(R-R.R/t _handle_event(R1R2R3((s0/usr/lib/python2.7/site-packages/spyral/event.pythandlens icCsD|dkrtjƒ}n|j|t|ƒf|||tƒdS(sŸ Registers an event `handler` to a namespace. Whenever an event in that `event_namespace` is fired, the event `handler` will execute with that event. :param event_namespace: the namespace of the event, e.g. ``"input.mouse.left.click"`` or ``"pong.score"``. :type event_namespace: str :param handler: A function that will handle the event. The first argument to the function will be the event. :type handler: function :param args: any additional arguments that need to be passed in to the handler. :type args: sequence :param kwargs: any additional keyword arguments that need to be passed into the handler. :type kwargs: dict :param int priority: the higher the `priority`, the sooner this handler will be called in reaction to the event, relative to the other event handlers registered. :param scene: The scene to register this event on; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/t _reg_internalRtFalse(tevent_namespacethandlertargsRtpriorityR3((s0/usr/lib/python2.7/site-packages/spyral/event.pytregisters cCs>|dkrtjƒ}n|j||f|||tƒdS(sv Similar to :func:`spyral.event.register` function, except that instead of passing in a function, you pass in the name of a property of this scene that holds a function. Example:: class MyScene(Scene): def __init__(self): ... self.register_dynamic("orc.dies", "future_function") ... :param str event_namespace: The namespace of the event, e.g. ``"input.mouse.left.click"`` or ``"pong.score"``. :param str handler: The name of an attribute on this scene that will hold a function. The first argument to the function will be the event. :param args: any additional arguments that need to be passed in to the handler. :type args: sequence :param kwargs: any additional keyword arguments that need to be passed into the handler. :type kwargs: dict :param int priority: the higher the `priority`, the sooner this handler will be called in reaction to the event, relative to the other event handlers registered. :param scene: The scene to register this event on; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/R7tTrue(R9thandler_stringR;RR<R3((s0/usr/lib/python2.7/site-packages/spyral/event.pytregister_dynamicžs! cCsD|dkrtjƒ}n|j|tt|ƒ|||tƒdS(sN Similar to :func:`spyral.event.register` function, except a sequence of `handlers` are be given instead of just one. :param str event_namespace: the namespace of the event, e.g. ``"input.mouse.left.click"`` or ``"pong.score"``. :type event_namespace: string :param handler: A list of functions that will be run on this event. :type handler: list of functions :param args: any additional arguments that need to be passed in to the handler. :type args: sequence :param kwargs: any additional keyword arguments that need to be passed into the handler. :type kwargs: dict :param int priority: the higher the `priority`, the sooner this handler will be called in reaction to the event, relative to the other event handlers registered. :param scene: The scene to register this event on; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/R7tmapRR8(R9thandlersR;RR<R3((s0/usr/lib/python2.7/site-packages/spyral/event.pytregister_multipleÄs cCs;|dkrtjƒ}n|j|||||tƒdS(sÎ Similar to :func:`spyral.Scene.register` function, except a sequence of strings representing handlers can be given instead of just one. :param event_namespace: the namespace of the event, e.g. ``"input.mouse.left.click"`` or ``"pong.score"``. :type event_namespace: string :param handler: A list of names of an attribute on this scene that will hold a function. The first argument to the function will be the event. :type handler: list of strings :param args: any additional arguments that need to be passed in to the handler. :type args: sequence :param kwargs: any additional keyword arguments that need to be passed into the handler. :type kwargs: dict :param int priority: the higher the `priority`, the sooner this handler will be called in reaction to the event, relative to the other event handlers registered. :param scene: The scene to register this event on; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/R7R>(R9thandler_stringsR;RR<R3((s0/usr/lib/python2.7/site-packages/spyral/event.pytregister_multiple_dynamicás  cCs/|dkrtjƒ}n|j||ƒdS(sË Unregisters a registered handler for that namespace. Dynamic handler strings are supported as well. :param str event_namespace: An event namespace :param handler: The handler to unregister. :type handler: a function or string. :param scene: The scene to unregister the event; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/t _unregister(R9R:R3((s0/usr/lib/python2.7/site-packages/spyral/event.pyt unregisters cCs,|dkrtjƒ}n|j|ƒdS(so Clears all handlers from namespaces that are at least as specific as the provided `namespace`. :param str namespace: The complete namespace. :param scene: The scene to clear the namespace of; if it is ``None``, then it will be attached to the currently running scene. :type scene: :class:`Scene ` or ``None`` N(R-R.R/t_clear_namespace(t namespaceR3((s0/usr/lib/python2.7/site-packages/spyral/event.pytclear_namespaces cCs“t|j}t|j}tƒ}x'|D]}t||t||ƒƒq*W|jdƒr|t|d|jdƒdƒn|jdƒr´tj j |j dƒ}|d|7}n|jdƒrêt t |jƒ\|_|_|_nh|jdƒrRy%t|jd }t|d |ƒWn tk r@t|jƒ}nX|d|7}n|jdƒr‰tj|jƒtjjƒj|_n||fS( se Convert a Pygame event to a Spyral event, correctly converting arguments to attributes. tinputttypet.iÿÿÿÿsinput.keyboardtunknownsinput.mouse.motions input.mouseiR$(R*RLR+Rtsetattrtgetattrt startswithtsplittkeyst reverse_maptgetRRAtboolR#RRRt MOUSE_MAPR$t IndexErrortstrR.tVec2DR!tdirectort get_scenet_scale(R2t event_attrst event_typetetattrtktm((s0/usr/lib/python2.7/site-packages/spyral/event.pyt_pygame_to_spyrals,     ' (t EventHandlercBs,eZdZd„Zd„Zgd„ZRS(s# Base event handler class. cCsg|_d|_dS(Ni(ii(t_eventst _mouse_pos(R((s0/usr/lib/python2.7/site-packages/spyral/event.pyR ?s cCsdS(s Should be called at the beginning of update cycle. For the event handler which is part of a scene, this function will be called automatically. For any additional event handlers, you must call this function manually. N((R((s0/usr/lib/python2.7/site-packages/spyral/event.pyttickCscCsºy |dWn*tk rntk r8|f}nX|gkr[|j}g|_|Sg|jD]}|d|kre|^qe}g|jD]}|d|kr‘|^q‘|_|S(sˆ Gets events from the event handler. Types is an optional iterable which has types which you would like to get. iRL(RXRRf(RttypestretR`((s0/usr/lib/python2.7/site-packages/spyral/event.pyRULs       ,/(R R R R RhRU(((s0/usr/lib/python2.7/site-packages/spyral/event.pyRe;s  tLiveEventHandlercBs,eZdZdd„Zd„Zd„ZRS(s An event handler which pulls events from the operating system. The optional output_file argument specifies the path to a file where the event handler will save a custom json file that can be used with the `ReplayEventHandler` to show replays of a game in action, or be used for other clever purposes. .. note:: If you use the output_file parameter, this function will reseed the random number generator, save the seed used. It will then be restored by the ReplayEventHandler. cCstj|ƒ|dk |_|jr‰t|dƒ|_tjdƒ}itj |ƒd6}t j |ƒ|jj t j|ƒdƒndS(NR&it random_seeds (ReR R-t_savetopent_filetosturandomtbase64t encodestringtrandomtseedtwritetjsontdumps(Rt output_fileRutinfo((s0/usr/lib/python2.7/site-packages/spyral/event.pyR qs   cCs;tjjƒ}tjjƒ}||_|jj|ƒdS(N(R)tmousetget_posR2RURgRftextend(RR{tevents((s0/usr/lib/python2.7/site-packages/spyral/event.pyRh{s cCs|jr|jjƒndS(N(RmRotclose(R((s0/usr/lib/python2.7/site-packages/spyral/event.pyt__del__„s N(R R R R-R RhR€(((s0/usr/lib/python2.7/site-packages/spyral/event.pyRkbs tReplayEventHandlercBs2eZdZd„Zd„Zd„Zd„ZRS(sp An event handler which replays the events from a custom json file saved by the `LiveEventHandler`. cCs[tj|ƒt|ƒ|_tj|jjƒƒ}tjt j |dƒƒt |_ dS(NRl( ReR RnRoRwtloadstreadlineRtRuRrt decodestringR8tpaused(Rt input_fileRz((s0/usr/lib/python2.7/site-packages/spyral/event.pyR Žs  cCs t|_dS(sg Pauses the replay of the events, making tick() a noop until resume is called. N(R>R…(R((s0/usr/lib/python2.7/site-packages/spyral/event.pytpause•scCs t|_dS(s/ Resumes the replay of events. N(R8R…(R((s0/usr/lib/python2.7/site-packages/spyral/event.pytresumeœscCs”|jr dSytj|jjƒƒ}Wntk rItjjƒnX|d}g|D]}t |ƒ^q[}|d|_ |j j |ƒdS(NR~R{( R…RwR‚RoRƒt ValueErrorR.R[tpopt EventDictRgRfR}(RtdR~R`((s0/usr/lib/python2.7/site-packages/spyral/event.pyRh¢s    (R R R R R‡RˆRh(((s0/usr/lib/python2.7/site-packages/spyral/event.pyR‰s    tModscBseZd„ZRS(cCsˆtj|_tj|_tj|_tj|_tj |_ tj |_ tj |_tj|_tj|_tj|_tj|_dS(N(R)t KMOD_NONEtnonet KMOD_LSHIFTtlshiftt KMOD_RSHIFTtrshiftt KMOD_SHIFTtshiftt KMOD_CAPStcapst KMOD_CTRLtctrlt KMOD_LCTRLtlctrlt KMOD_RCTRLtrctrlt KMOD_LALTtlaltt KMOD_RALTtralttKMOD_ALTtalt(R((s0/usr/lib/python2.7/site-packages/spyral/event.pyR ¯s          (R R R (((s0/usr/lib/python2.7/site-packages/spyral/event.pyR®stKeyscBs,eZd„Zd„Zd„Zd„ZRS(cCs7i|_|jtjƒdƒ|jddgƒdS(Ns"resources/default_key_mappings.txttreturntentertbreaktbrk(sreturnR¦(sbreakR¨(RTtload_keys_from_fileR.t_get_spyral_patht_fix_bad_names(R((s0/usr/lib/python2.7/site-packages/spyral/event.pyR ¾s   cCsAx:|D]2\}}t||t||ƒƒt||ƒqWdS(sM Used to replace any binding names with non-python keywords. N(RORPtdelattr(Rtrenamestoriginaltnew((s0/usr/lib/python2.7/site-packages/spyral/event.pyR«ÅscCsñt|ƒ}|jƒ}|jƒxÈ|D]À}|d jdƒ}t|ƒdkr)|ddd!dkr­t||dt|ddƒƒ|d|jt|ddƒsJ           %   ''%#