a V$c@s:ddlmZmZmZmZmZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZmZddlmZddlZddlZddlZddlZejj dddddZiZGd d d ejjZd d Ze e!Z"Gd ddeZ#e#Z$ddZ%GdddejjZ&dZ'dZ(dZ)dZ*dZ+gdZ,Gdddej-j.j/Z0da1ddkrga?ia@gaAd"d#ZBd$d%ZCd&d'ZDd(d)ZEd*d+ZFd,d-ZGdId.d/ZHd0d1ZId2d3ZJd4d5ZKd6d7ZLdJd8d9ZMd:d;ZNdd?ZPePZQdLd@dAZReRZSdBdCZTdDdEZUdFdGZVdS)M)divisionabsolute_importwith_statementprint_functionunicode_literals) PY2 basestringbchrbordchropenpystrrangeroundstrtobytesunicode)OptionalNprofile_screenTF) developerappendflushc@seZdZdZdddZdS) ScreenProfilez? :doc: profile_screen :name: renpy.profile_screen Fc CsT||_||_||_||_||_||_||_|durPt|trPt | }|t |<dS)a Requests screen profiling for the screen named `name`, which must be a string. Apart from `name`, all arguments must be supplied as keyword arguments. This function takes three groups of arguments. The first group of arguments determines when profiling occurs. `predict` If true, profiling occurs when the screen is being predicted. `show` If true, profiling occurs when the screen is first shown. `update` If true, profiling occurs when the screen is updated. `request` If true, profiling occurs when requested by pressing F8. The second group of arguments controls what profiling output is produced when profiling occurs. `time` If true, Ren'Py will log the amount of time it takes to evaluate the screen. `debug` If true, Ren'Py will log information as to how screens are evaluated, including: * Which displayables Ren'Py considers constant. * Which arguments, if any, needed to be evaluated. * Which displayables were reused. Producing and saving this debug information takes a noticeable amount of time, and so the `time` output should not be considered reliable if `debug` is set. The last group of arguments controls what output is produced once per Ren'Py run. `const` Displays the variables in the screen that are marked as const and not-const. All profiling output will be logged to profile_screen.txt in the game directory. N) predictshowupdaterequesttimedebugconst isinstancertuplesplitprofile) selfnamerrrrrrrr&renpy/display\screen.py__init__0s5  zScreenProfile.__init__N)FFFFFFF__name__ __module__ __qualname____doc__r(r&r&r&r'r)srcCs2t|trt|}|tvr&t|StdSdS)z Returns the profile object for the screen with `name`, or a default profile object if none exists. `name` A string or tuple. N)r rr!r"r#rr%r&r&r' get_profileus  r/c@seZdZdZddZdS) ScreenCachezh Represents an entry in the screen cache. Upon creation, puts itself into the screen cache. cCsP|jdurdS||_||_||_t|}||t|tjj krL| ddSNr) astargskwargscache predict_cacherlenrenpyconfigscreen_cache_sizepop)r$screenr3r4r5pcr&r&r'r(s  zScreenCache.__init__Nr)r&r&r&r'r0sr0cCsZ|jduriSt|}|siS|D]&}|j|kr"|j|kr"||qTq"|d}|jS)zZ Returns the cache to use when `screen` is accessed with `args` and `kwargs`. Nr)r2r6r3r4remover;r5)r<r3r4r=scr&r&r' cache_gets   r@c @s"eZdZdZdZdZd dd ZdS) Screenz~ A screen is a collection of widgets that are displayed together. This class stores information about the screen. TrueNFalse0Fscreensc Cst|trt|}||_|dus.t|tr4|g}|D]$} |t|d| f<|t|d| <q8||_t|tj j j r|||_ nd|_ ||_ ||_|p|d|_|durtjj}||_||_| |_| |_| |_| |_dadadSNrF)r rr!r"r%rEscreens_by_namefunctionr8sl2slastSLScreenr2modalzordertagr9predict_screensr parameterslocationlayer sensitive roll_forwardpreparedanalyzed)r$r%rHrLrMrNrvariantrPrQrRrSrTvr&r&r'r(s2  zScreen.__init__) rCrDNNNFNrErBN)r*r+r,r-rSrTr(r&r&r&r'rAsrA)PREDICTSHOWUPDATEHIDEOLDcseZdZdZgdZdZdZdZddZiidffdd Z e dd Z d d Z d d Z d+ddZddZfddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*ZZS),ScreenDisplayablez A screen is a collection of widgets that are displayed together. This class is responsible for managing the display of a screen. )r<childchildren transformswidgets base_widgets old_widgetshidden_widgetsold_transformsr5 miss_cacher#phase use_cacheFcCsrt|jd|_d|_g|_i|_i|_i|_d|_d|_ d|_ i|_ i|_ t |_i|_i|_t|jd|_dSrF)get_screen_variant screen_namer<rcrdrerfrgrhrj old_transfersrir5r_rlrmrkr#getr$r&r&r'after_setstateEsz ScreenDisplayable.after_setstatec  s@tt|jfi|||_||_|j|_|jj|_t |jd|_ ||_ ||_ t j||_d|_||_i|_i|_i|_|r|rt||}nd}|dur|j|_ni|_|dur|j|_ni|_i|_d|_d|_|o|j|jk|_d|_i|_d|_d|_ ||_!t j"j#|jj$|jd|_$t j"j#|jj%|jd|_%t&|_'dS)NFlocals)(superrbr( propertiesr<r%rorQ _locationr#rqrNrRr8 revertableRevertableDictscopercwidget_propertiesrfrgr5 get_screenrermrkrhrjrpcurrent_transform_eventri restartinghiding transientpythonpy_evalrLrMr]rl) r$r<rNrRr|r{rrw old_screen __class__r&r'r(WsF    zScreenDisplayable.__init__cCs d|jS)N )joinrorrr&r&r'r%szScreenDisplayable.namecCs|jSNr.rrr&r&r' _repr_infoszScreenDisplayable._repr_infocCs|jgSr)rcrrr&r&r'visitszScreenDisplayable.visitNcCsB||z,t||jdur,|jj|ddWtnt0dS)N)seen)push_current_screenrc visit_allpop_current_screen)r$callbackrr&r&r'rs  zScreenDisplayable.visit_allcCstjj|d|dSr1)r8displayrenderredrawrrrr&r&r' per_interactszScreenDisplayable.per_interactcstt||||_dSr)rvrbset_transform_eventr~r$eventrr&r'rsz%ScreenDisplayable.set_transform_eventcCsh|jtkp|jtk}|jr0t|js0tjjz*t ||j rR|sR|j ||Wt nt 0dSr) rlrar`rLcallabler8rfocus mark_modalrrcfind_focusabler)r$r focus_namerr&r&r'rs  z ScreenDisplayable.find_focusablecCsZt|j|j|j|j|jfi|j}|j|_|j |_ |j |_ d|_ |j |_ |S)NT) rbr<rNrRr|r{rwrecopyrfrgrprcr$rvr&r&r'rs$   zScreenDisplayable.copycCs(|jdur|jrdS||j|S)NF)rcrr_handles_eventrr&r&r'rs  z ScreenDisplayable._handles_eventc Csn|jtkr|}n|jdur*|j|s*dSt|||jdurJdS|jdurXdS|j|shdS|jjdur|jj |j di| }|jj D]}||qt|_d}|j}t|tjjjsdStjtjjdd|jd|_|jg|_ tj|j D]>}||||} | durtjj| d|j| |}q|durjtjj|d|S)Nr_screen__r)rlr`rcrupdated_screensdiscardrr<r2copy_on_changer5rqrrdrr r8rlayoutMultiBoxuidetached default_fixedrroclose_hiderradd) r$statkindhidir old_childdcr&r&r'rsF               zScreenDisplayable._hidecCsj|jdur|S|jdur|Stjjs(|S|jjdurL|jj|jdi| }t |_ |j |_|Sr1) r<rcr8r9transition_screensr2rr5rqrrarl_in_current_storerr&r&r'r1s    z#ScreenDisplayable._in_current_storec Cs|tvr dSt||jdur6tjjjdd|_iS|jsP|j t ksP|j t krn|jshtjjjdd|_|j Sd}d}|j r |j tkr|j jrd}n.|j tkr|j jrd}n|j tkr|j jrd}tjjjr|j jrd}|r tdt|j d|jtjdt}|j j r d}|j |_!|j"|_#i|_ i|_$i|_"t%|tj&j}|tj&_d}|j'(|d}ztj&)tj&j*d d |jd |_|jg|_+|j,|j,d <||j,d <||j,d<|jj-fi|j,tj&.W|j,/d d|tj&_t0n|j,/d d|tj&_t00d|_!d|_#d|_1|j2r>|j23|j'(|d|urp|j4durp|j tkrpd|_4|j4r|jj+D]}|5|j4qd|_4|rt}|j jrtdd|||j j rtd|j S)Nfixed)rFTz%s %s %srz %H:%M:%S.%frrrr_scope_name_debugrz * %.2f msi )6rrr<r8rrrrcrrlr`rarfr#r_rr^rr]r interface profile_oncer profile_logwrite phase_namerrodatetimenowstrftimerrrhrerjrgrrr5rqrrrdr{rHrr;rrprkclearr~r) r$r#rstart old_ui_screenNAME old_cacherendr&r&r'rEs           ,    zScreenDisplayable.updatec Cs|js||jtkrt|_z*t|tjj|j||||}Wt nt 0tjj ||}||_ |jt kpz|jt k}|jdurd}ntjj|jj|jd}|j|d|o| | d|jo| |_|S)NFrt)rr)rmain)rcrrlr^r_rr8rrrRender focus_screenrar`r<rrrSr{blitrL) r$whrrrcrrrSr&r&r'rs"  zScreenDisplayable.rendercCs|js||jSr)rcr get_placementrrr&r&r'rszScreenDisplayable.get_placementcCs|jtks|jtkrdS|js"dStjj|jj|jdsBtj j j }z$t ||j ||||}Wtnt0|dur||Stj j|j|||ddrtj jdS)Nrt)rlrar`r<r8rrrSr{rr time_eventrrcrrr check_modalrL IgnoreLayers)r$evxyrrr&r&r'rs zScreenDisplayable.eventcCs t|jSr)rrlrrr&r&r'get_phase_namesz ScreenDisplayable.get_phase_namecCs<|jtks|jtkrdS|jr0tjj|S|SdS)N) rlrar`rLr8rttsTTSDone _tts_commonrrr&r&r'_ttss zScreenDisplayable._tts)N)r*r+r,r-nosaverrrrsr(propertyr%rrrrrrrrrrrrrrrr __classcell__r&r&rr'rb+s2a     9qrbcCstt|adSr)current_screen_stackr_current_screen)r<r&r&r'r s rcCs tadSr)rr;rr&r&r&r'rsrcCs>|durtjj}|D]$}t||fd}|dur|SqdS)zi Get a variant screen object for `name`. `candidates` A list of candidate variants. N)r8r9variantsrErq)r% candidatesrrr&r&r'rn s rncCs:t|trt|}|d}|tvr*gStt|S)z Gets all variants of the screen with `name`. Returns a list of (`variant`, `screen`) tuples, in no particular order. r)r rr!r"rGlistitemsr.r&r&r'get_all_screen_variants3s   rcsttkr tSttttddtDtD]>\}}|d|jsVq6fdd}|j|q6g}ddD}|r| | D]$}|}| |s| |q=qt at|atta|S)zG Produces a list of SL2 screens in topologically sorted order. cSsh|] }|dqS)rr&).0rr&r&r' fzsort_screens..rcs,|vr dS||dSr)r)usesdependsr%namesreverser&r'rrszsort_screens..callbackcSsh|]\}}t|s|qSr&)r7)rkrXr&r&r'r~r)screens_at_sortrEsorted_screens collections defaultdictsetrr2 used_screensr;rr>rrkeys use_cyclesortdict)rrXrrworksetrrr&rr' sort_screensTs8        rcCs&g}tD]}|t|q |S)zB Produces a list of screen variants in topological order. )rextendrGvalues)rr%r&r&r'sorted_variantss rcCs2trdStD]}|jdurq|jqdadS)z Analyzes all screens. NT)rVrr2analyze_screen)sr&r&r'analyze_screenss   rcCstrdSttjjj}dtjj_zHts0tt D]$}|j durFq6|j |j q6daW|tjj_n |tjj_0tj jrtrtddtddS)z' Prepares all screens for use. NTz0The following screens use each other in a loop: z, z. This is not allowed.)rUr6rr8rr predictingrVrrr2unprepare_screenprepare_screenr9rr Exceptionr)old_predictingrr&r&r'prepare_screenss"       r cOst|i|dS)a :undocumented: :args: (name, function, modal="False", zorder="0", tag=None, variant=None) Defines a screen with `name`, which should be a string. `function` The function that is called to display the screen. The function is called with the screen scope as keyword arguments. It should ignore additional keyword arguments. The function should call the ui functions to add things to the screen. `modal` A string that, when evaluated, determines of the created screen should be modal. A modal screen prevents screens underneath it from receiving input events. `zorder` A string that, when evaluated, should be an integer. The integer controls the order in which screens are displayed. A screen with a greater zorder number is displayed above screens with a lesser zorder number. `tag` The tag associated with this screen. When the screen is shown, it replaces any other screen with the same tag. The tag defaults to the name of the screen. `predict` If true, this screen can be loaded for image prediction. If false, it can't. Defaults to true. `variant` String. Gives the variant of the screen to use. N)rA)r3r4r&r&r' define_screens(r cCs0t|ts|d}t|}|dur&dS|jSdS)zC Returns the layer that the screen with `name` is part of. rNrE)r rrnrR)r%r<r&r&r'get_screen_layers  r cCs||durt|}t|tr |f}tj}|D] }|||}|dur.|Sq.|D]"}|||f}|durT|SqTdS)a :doc: screens Returns the ScreenDisplayable with the given `name` on `layer`. `name` is first interpreted as a tag name, and then as a screen name. If the screen is not showing, returns None. This can also take a list of names, in which case the first screen that is showing is returned. This function can be used to check if a screen is showing:: if renpy.get_screen("say"): text "The say screen is showing." else: text "The say screen is hidden." The ScreenDisplayable objects returned by this function have the following documented fields: .. attribute:: ScreenDisplayable.layer The layer the screen is being displayed on. .. attribute:: ScreenDisplayable.name The name of the screen. .. attribute:: ScreenDisplayable.zorder The zorder the screen is being displayed at. N)r r rr8exports scene_listsget_displayable_by_tagget_displayable_by_name)r%rRslrNsdr&r&r'r}s"     r}cCs6t|tst|}|sdSt|dr.dSdSdS)z> Returns true if a screen with the given name exists. FrTN)r r!r"rnr.r&r&r' has_screenOs   rcCsF|}t|tst|}t|d}|dur@td|df|jS)zX Given a screeen name, determines if roll forward is enable for the screen. rNScreen %s is not known. )r r!r"rnrrT)ror%r<r&r&r'get_screen_roll_forward`s   rc OsT|dd}|dd}|di}|dd}|dd}|}t|tsVt|}t|d} | dur|td |df|durt|}|dur| j}i} | jr|| d <|| d <n | |t | |||| |d } |dur| j }t ||} | r| j r| j | _ t| ||| _t| _nt| ||| _ t| _tjj} | j|| |||d |ddS)aS :doc: screens The programmatic equivalent of the show screen statement. Shows the named screen. This takes the following keyword arguments: `_screen_name` The name of the screen to show. `_layer` The layer to show the screen on. `_zorder` The zorder to show the screen on. If not specified, defaults to the zorder associated with the screen. It that's not specified, it is 0 by default. `_tag` The tag to show the screen with. If not specified, defaults to the tag associated with the screen. It that's not specified, defaults to the name of the screen. `_widget_properties` A map from the id of a widget to a property name -> property value map. When a widget with that id is shown by the screen, the specified properties are added to it. `_transient` If true, the screen will be automatically hidden at the end of the current interaction. Non-keyword arguments, and keyword arguments that do not begin with an underscore, are passed to the screen. _layerN_tag_widget_properties _transientF_zorderrr_kwargs_args)rT)rMrkeep_str%)r;r r!r"rnrr rNrPrrbrMr}r5r@rkr_rlr^r8rcorer r) _screen_namerr4rrrrrr%r<r{rold_dslsr&r&r' show_screenss@            r!c Osx|dd}|dd}|di}|dd}|}tjjrLtjjd|t|tsbt| }t |d}|durzdS|j sdS|durt |}i} | | d <|j r|| d <|| d <n | |zzHt|dd|| } t|||| _| t|||| jtjj | Wn>tyJtjjrFddl} td || tYn0W| d dn| d d0tjdS) a Predicts the displayables that make up the given screen. `_screen_name` The name of the screen to show. `_widget_properties` A map from the id of a widget to a property name -> property value map. When a widget with that id is shown by the screen, the specified properties are added to it. Keyword arguments not beginning with underscore (_) are used to initialize the screen's scope. rNrrrFzPredict screen %srrrrzWhile predicting screen)r;r8r9debug_predictionric_logrr r!r"rnrr rPrrbr@r5 cache_put displayabler tracebackprint print_excrreset) rrr4rrrrr%r<r{rr&r&r&r'predict_screensH           r*cCs:|durt|f}t||}|dur6tjj|j|ddS)z :doc: screens The programmatic equivalent of the hide screen statement. Hides the screen with `tag` on `layer`. N)rR)r r}r8r hiderN)rNrRr<r&r&r' hide_screen s   r,c Os|dd}|di}|}t|ts2t|}t|d}|durTtd|ftj}dt_|jr|i}||d<||d<n| }| |||d<||f|d<z |j fi|W|ddn|dd0|t_dS) Nrr&rrzScreen %r is not known.Trr) r;r r!r"rnrrrprPrrrH) rrr4rrr%r<rpr{r&r&r' use_screens,        r-cCstS)z :doc: screens :name: renpy.current_screen Returns the ScreenDisplayable corresponding to the screen currently being updated, rendered, or processed. See :func:`get_screen` for documented fields on ScreenDisplayable. )rr&r&r&r'current_screenCs r.cCst|tr|j}|dur t}n|dur0t|}t||}t|tsHdS|jdurZ||rn|j |d}n|j |d}|S)z :doc: screens :name: renpy.get_displayable From the `screen` on `layer`, returns the displayable with `id`. Returns None if the screen doesn't exist, or there is no widget with that id on the screen. N) r rbror.r r}rcrrgrqrf)r<idrRbaserr&r&r'get_displayableQs    r1cCsT|durt}n|dur t|}t||}|dur6iS|j|d}|durPi}|S)a :doc: screens :name: renpy.get_displayable_properties Returns the properties for the displayable with `id` in the `screen` on `layer`. If `screen` is None, returns the properties for the current screen. This can be used from Python or property code inside a screen. Note that this returns a dictionary containing the widget properties, and so to get an individual property, the dictionary must be accessed. N)r.r r}r|rq)r/r<rRrrr&r&r'get_displayable_propertiesws r2cCsBtjjjD].\}}|dur q|jD]}t|tr&d|_q&qdS)z This is called before Ren'Py restarts to put the screens into restart mode, which prevents crashes due to variables being used that are no longer defined. NT) r8rr old_scenerrdr rbr)rrRrr&r&r'before_restarts   r4cCs| }tjjdur|}ntjjdur*d}nd}|rVtjjD]}t|dur:t|q:n"tjjD]}t|dur^t|q^tjjD]}t|durt|qdS)zC Called from interact to show or hide the overlay screens. NTF) r8store_overlay_screensr9overlay_screensr}r!r,always_shown_screens)suppress_overlayrrr&r&r'show_overlay_screenss           r:cCsDtjjD]6}t|}|durqt|tjj|| qdS)zi Called from interact once per frame to invalidate screens we want to update once per frame. N) r8r9per_frame_screensr}rrrr invalidater)rrr&r&r' per_frames  r=)N)N)N)NF)NN)W __future__rrrrr renpy.compatrrr r r r r rrrrrtypingrr8rrrlogrr#objectObjectrr/rrr6r0r$r@rAr]r^r_r`rarrr Containerrbrr<rrrrErrGrrrnrrVrUrrrrrrr r r r}rrr!r*r,r-r.r1 get_widgetr2get_widget_propertiesr4r:r=r&r&r&r's~8 L V X   C $+ 9RG % # !