ó ÔŒ\c@sSddlmZddlZddlmZmZddlmZmZeeddde dde d„Z dde ddd„Z dd „Zddd „Ze d „Zd „Zdd „Zdd„Zdd„Zdd„Zdd„Zddd„Zdd„Zdd„Zdd„Zdd„Ze d„Zd„Zd„ZdS(iÿÿÿÿ(tprint_functionN(t get_channelt get_serial(tregister_channelt alias_channeltmusicicCsõtjjƒjr!tdƒ‚n|dkr1dSt|tƒrL|g}ntjjj ”yst |ƒ}|j} |dkrŒ|j }n|dkr­tj j r­|}n|j|k} |jƒ|dkrátj j}n|r|jƒ|krd}| } n|j|ƒt} tj jrCtj jrC| rCt} nt} | r}|j|d|d|d|d|d| ƒntƒ} | | _| |_|r³|| _|| _ng| _t| _t| _Wntj jrë‚qënXWdQXdS( s‘ :doc: audio This stops the music currently playing on the numbered channel, dequeues any queued music, and begins playing the specified file or files. `filenames` This may be a single file, or a list of files to be played. `channel` The channel to play the sound on. `loop` If this is True, the tracks will loop while they are the last thing in the queue. `fadeout` If not None, this is a time in seconds to fade for. Otherwise the fadeout time is taken from config.fade_music. `synchro_start` Ren'Py will ensure that all channels of with synchro_start set to true will start playing at exactly the same time. Synchro_start should be true when playing two audio files that are meant to be synchronized with each other. `fadein` This is the number of seconds to fade the music in for, on the first loop only. `tight` If this is True, then fadeouts will span into the next-queued sound. If None, this is true when loop is True, and false otherwise. `if_changed` If this is True, and the music file is currently playing, then it will not be stopped/faded out and faded back in again, but instead will be kept playing. (This will always queue up an additional loop of the music.) This clears the pause flag for `channel`. s#Can't play music during init phase.Nitloopt synchro_starttfadeinttightt loop_only(trenpytgametcontextt init_phaset ExceptiontNonet isinstancet basestringtaudiotlockRt default_looptconfigttight_loop_defaultRtdequeuet fade_musict get_playingtfadeouttFalset skip_soundstskippingtTruetenqueueRt last_changedtlast_filenamest last_tighttpauset debug_sound(t filenamestchannelRRRRR t if_changedtctctxtloop_is_filenamesR R tt((srenpy/audio/music.pytplay#sP,            .         c Cs»tjjƒjr!tdƒ‚n|dkr<g}t}nt|tƒrW|g}ntj j dkrvt |ƒntj j j 0yt|ƒ}|j}|dkr¶|j}n|dkr×tj jr×|}n|rí|jtƒntj jrtj j r| rt}nt}|rC|j|d|d|d|ƒntƒ} | |_| |_|ry||_||_ng|_t|_t|_Wntj jr±‚q±nXWdQXdS(sÏ :doc: audio This queues the given filenames on the specified channel. `filenames` This may be a single file, or a list of files to be played. `channel` The channel to play the sound on. `loop` If this is True, the tracks will loop while they are the last thing in the queue. `clear_queue` If True, then the queue is cleared, making these files the files that are played when the currently playing file finishes. If it is False, then these files are placed at the back of the queue. In either case, if no music is playing these files begin playing immediately. `fadein` This is the number of seconds to fade the music in for, on the first loop only. `tight` If this is True, then fadeouts will span into the next-queued sound. If None, this is true when loop is True, and false otherwise. This clears the pause flag for `channel`. s#Can't play music during init phase.tfastRRR N(R R R RRRRRRRRtstopRRRRRRRRR RR!R"R#R$R%( R&R'Rt clear_queueRR R)R*R R,((srenpy/audio/music.pytqueueŒsH!          "         cCsEt|ƒ}|j|tƒ\}}}tjj|j||jƒS(s¡ Return true if the given filename is playable on the channel. This takes into account the prefix and suffix, and ignores a preceding specifier. (Rtsplit_filenameRR tloadertloadablet file_prefixt file_suffix(tfilenameR'R)t_((srenpy/audio/music.pytplayableäs cCsºtjjƒjrdStjjjynt|ƒ}|j}|dkrYtjj }n|j |ƒt ƒ}||_ ||_ g|_ t|_Wntjjr°‚q°nXWdQXdS(së :doc: audio This stops the music that is currently playing, and dequeues all queued music. If fadeout is None, the music is faded out for the time given in config.fade_music, otherwise it is faded for fadeout seconds. This sets the last queued file to None. `channel` The channel to stop the sound on. `fadeout` If not None, this is a time in seconds to fade for. Otherwise the fadeout time is taken from config.fade_music. N(R R R RRRRRRRRRR!R"RR#R%(R'RR)R*R,((srenpy/audio/music.pyR/òs"          cCs5t|ƒ}|r|jrdS||_t|_dS(s5 Determines if channel will loop by default. N(Rtdefault_loop_setRR(R'tflagtdefaultR)((srenpy/audio/music.pyt set_music s   cCst|ƒ}|jS(s9 Returns true if "channel" will loop by default. (RR(R'R)((srenpy/audio/music.pytis_music.s cCsuyTtjjj|ƒ}|jƒ}| s7|dkr;dS||krKdS||SWntjjrl‚ndSXdS(sS Returns the number of seconds left until the given time in the music. iN(R RRtget_posRRR%(ttimeR'R)R,((srenpy/audio/music.pyt get_delay7s    cCseyDtjjj|ƒ}|jƒ}| s7|dkr;dS|dSWntjjr\‚ndSXdS(sU :doc: audio Returns the current position of the audio or video file on `channel`, in seconds. Returns None if no audio is playing on `channel`. As this may return None before a channel starts playing, or if the audio channel involved has been muted, callers of this function should always handle a None value. ig@@N(R RRR?RRR%(R'R)R,((srenpy/audio/music.pyR?Ps    cCsDy#tjjj|ƒ}|jƒSWntjjr;‚ndSXdS(sŒ :doc: audio Returns the duration of the audio or video file on `channel`. Returns 0.0 if no file is playing on `channel`. N(R RRt get_durationRR%R(R'R)((srenpy/audio/music.pyRBls cCsDy#tjjj|ƒ}|jƒSWntjjr;‚ndSXdS(sw :doc: audio If the given channel is playing, returns the playing file name. Otherwise, returns None. N(R RRRRR%R(R'R)((srenpy/audio/music.pyRs cCstd|ƒdk S(s’ :doc: audio Returns True if the channel is currently playing a sound, False if it is not, or if the sound system isn't working. R'N(RR(R'((srenpy/audio/music.pyt is_playing‘scCsIy)tjjj|ƒ}|j||ƒWntjjrE‚qEnXdS(sï :doc: audio Sets the volume of this channel, as a fraction of the volume of the mixer controlling the channel. `volume` This is a number between 0.0 and 1.0, and is interpreted as a fraction of the mixer volume for the channel. `delay` It takes delay seconds to change/fade the volume from the old to the new value. This value is persisted into saves, and participates in rollback. `channel` The channel to be set N(R RRtset_secondary_volumeRR%(tvolumetdelayR'R)((srenpy/audio/music.pyt set_volumeœs  cCsIy)tjjj|ƒ}|j||ƒWntjjrE‚qEnXdS(s; :doc: audio Sets the pan of this channel. `pan` A number between -1 and 1 that control the placement of the audio. If this is -1, then all audio is sent to the left channel. If it's 0, then the two channels are equally balanced. If it's 1, then all audio is sent to the right ear. `delay` The amount of time it takes for the panning to occur. `channel` The channel the panning takes place on. This can be a sound or a music channel. Often, this is channel 7, the default music channel. N(R RRtset_panRR%(tpanRFR'R)((srenpy/audio/music.pyRH¸s  cCsBy"tjjj|ƒ}||_Wntjjr>‚q>nXdS(sÌ :doc: audio This sets a callback that is called when the queue is empty. This callback is called when the queue first becomes empty, and at least once per interaction while the queue is empty. The callback is called with no parameters. It can queue sounds by calling renpy.music.queue with the appropriate arguments. Please note that the callback may be called while a sound is playing, as long as a queue slot is empty. N(R RRtcallbackRR%(RJR'R)((srenpy/audio/music.pytset_queue_empty_callbackÔs   cCsEy%tjjj|ƒ}||j_WntjjrA‚qAnXdS(sŽ :doc: audio Sets the pause flag for `channel` to `value`. If True, the channel will pause, otherwise it will play normally. N(R RRR R$RR%(tvalueR'R)((srenpy/audio/music.pyt set_pauseés  cCs2y#tjjj|ƒ}|jjSWntSXdS(s@ :doc: audio Returns the pause flag for `channel`. N(R RRR R$R(R'R)((srenpy/audio/music.pyt get_pauseøs cCs[y;tjjj|ƒ}| s.|jdkr:||_nWntjjrW‚qWnXdS(s¬ This sets the name of the mixer associated with a given channel. By default, there are two mixers, 'sfx' and 'music'. 'sfx' is on channels 0 to 3, and 'music' on 3 to 7. The voice module calls this function to set channel 2 to voice. You can create your own mixer, but will need to add a preference if you wish to allow the user to set it. This function should only be called in an init block. N(R RRtmixerRRR%(R'ROR<R)((srenpy/audio/music.pyt set_mixers  cCs=tƒ}x'tjjjD]}|j|jƒqWt|ƒS(s& This gets all mixers in use. (tsetR Rt all_channelstaddROtlist(trvti((srenpy/audio/music.pytget_all_mixerss cCs*ytjjj|ƒtSWntSXdS(sA Returns True if the channel exists, or False otherwise. N(R RRRR(R'((srenpy/audio/music.pytchannel_defined*s (t __future__Rt renpy.audioR trenpy.audio.audioRRRRRRR-RR1R9R/R=R>RAR?RBRRCRGRHRKRMRNRPRWRX(((srenpy/audio/music.pyts0 iX .