j* dZddlmZddlmZddlmZddlZddlm Z ddl m Z ddlm Z dd l mZGd d e ZGd d ZGddejZGddejZedkrddlZejedSdS)a Objects for realtime playback of Music21 Streams as MIDI. From an idea of Joe "Codeswell": https://joecodeswell.wordpress.com/2012/06/13/how-to-produce-python-controlled-audio-output-from-music-made-with-music21 https://stackoverflow.com/questions/10983462/how-can-i-produce-real-time-audio-output-from-music-made-with-music21 Requires pygame 2 (or 1.9) install with: pip3 install pygame ) annotations) find_spec)BytesION)defaults)Music21Exception)stream) translateceZdZdS)StreamPlayerExceptionN__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/midi/realtime.pyr r "Drr ceZdZdZdZ dddZ deddddZdZ deddddZ dZ dS) StreamPlayera) Create a player for a stream that plays its midi version in realtime using pygame. Set up a detuned piano (where each key has a random but consistent detuning from 30 cents flat to sharp) and play a Bach Chorale on it in real time. >>> import random >>> keyDetune = [] >>> for i in range(127): ... keyDetune.append(random.randint(-30, 30)) >>> #_DOCS_SHOW b = corpus.parse('bwv66.6') >>> #_DOCS_SHOW for n in b.flatten().notes: >>> class PitchMock: midi = 20 #_DOCS_HIDE >>> class Mock: pitch = PitchMock() #_DOCS_HIDE >>> #_DOCS_HIDE -- should not play back in doctests, see TestExternal >>> n = Mock() #_DOCS_HIDE >>> for i in [1]: #_DOCS_HIDE ... n.pitch.microtone = keyDetune[n.pitch.midi] >>> #_DOCS_SHOW sp = midi.realtime.StreamPlayer(b) >>> #_DOCS_SHOW sp.play() The stream is stored (unaltered) in `StreamPlayer.streamIn`, and can be changed any time the midi file is not playing. A number of mixer controls can be passed in with keywords: * mixerFreq (default 44100 -- CD quality) * mixerBitSize (default -16 (=unsigned 16bit) -- really, are you going to do 24bit audio with Python?? :-) ) * mixerChannels (default 2 = stereo) * mixerBuffer (default 1024 = number of samples) FDstreamIn stream.Stream reinitMixerbool mixerFreqint mixerBitSize mixerChannels mixerBufferc ddl}||_n#t$rtdwxYw|jdus|r|j||||||_dS)Nrz,StreamPlayer requires pygame. Install firstF)pygame ImportErrorr mixerInitializedmixerinitr)selfrrrr r!r"r$s r__init__zStreamPlayer.__init__Ks X MMM DKK X X X'(VWW W X  E ) )[ ) L  i}k R R R  s (N2infT)playForMillisecondsblockedc h|}|||||||||dS)a busyFunction is a function that is called with busyArgs when the music is busy every busyWaitMilliseconds. endFunction is a function that is called with endArgs when the music finishes playing. playForMilliseconds is the amount of time in milliseconds after which the playback will be automatically stopped. If blocked is False, the method will finish before ending the stream, allowing you to completely control whether to stop it. Ignore every other arguments ) busyFunctionbusyArgs endFunctionendArgsbusyWaitMillisecondsr-r.N)getStringOrBytesIOFileplayStringIOFile) r)r0r1r2r3r4r-r.streamStringIOFiles rplayzStreamPlayer.play_sU*"88:: 0+7'/*5&-3G2E&-  / / / / /rcztj|j}|}t |SN) midiTranslatestreamToMidiFilerwritestrr)r)streamMidiFilestreamMidiWrittens rr5z#StreamPlayer.getStringOrBytesIOFile~s5&7 FF*3355()))rc|jj} |jjj|n-#|jj$r} td|d| | d} ~ wwxYw|jjj|sdStd|z } |jj } |jjj r| |||jj | z |kr$|jjj n8| | |jjj | ||dSdS)a' busyFunction is a function that is called with busyArgs when the music is busy every busyWaitMilliseconds. endFunction is a function that is called with endArgs when the music finishes playing. playForMilliseconds is the amount of time in milliseconds after which the playback will be automatically stopped. If blocked is False, the method will finish before ending the stream, allowing you to completely control whether to stop it. Ignore every other arguments but for stringIOFile zCould not play music file z because: N)r$timeClockr'musicloaderrorr r8r get_ticksget_busystoptick) r) stringIOFiler0r1r2r3r4r-r. pygameClockpge framerate start_times rr6zStreamPlayer.playStringIOFiles k&,,..   K  # ( ( 6 6 6 6{    'J\JJSJJ   $$&&&  F3344 [%//11 k%..00 (' X&&&{))++j8;NNN !',,...   Y ' ' ' k%..00 (  " K  # "s$AA/A**A/cL|jjjdSr:)r$r'rDrI)r)s rrIzStreamPlayer.stops" $$&&&&&r)Frrrr) rrrrrrr rr!rr"r)NNNNr+) r rr__doc__r&r*floatr8r5r6rIrrrrr&s!!D "!!!!!*"$ /"'u/////>*** JNNP%!.3U5\\4%!%!%!%!%!N'''''rrceZdZdS)TestNr rrrrTrTrrrTcxeZdZedZedZndZejeddZdZ dZ d Z dS) TestExternalr$NTFzpygame is not installedctddlm}ddl}|d}g}t dD]+}||dd,|jD]}||j j |j _ t|}| dS)Nrcorpusbwv66.6)music21rYrandomparserangeappendrandintrecursenotespitchmidi microtonerr8)r)rYr_b keyDetuneinsps rtestBachDetunezTestExternal.testBachDetunes"""""" LL # # s 6 6A   V^^C44 5 5 5 5" 8 8A )!', 7AG   !__  rcddlm}ddl}d}Gdd}|}d|_|d}g}t d D]+}||d d ,|j D]} || j j | j _ t|} | ||gd dS) zN tests to see if the busyCallback function is called properly rrXNcp|d}|xj|jz c_td|jddS)Nrz hi! waited z milliseconds)times updateTimeprint)timeListtimeCounter_inners r busyCounterz4TestExternal.x_testBusyCallback..busyCountersH (   # #'8'C C # # F 1 7FFF G G G G GrceZdZdZdS)-TestExternal.x_testBusyCallback..MockrN)r rrrqrrrMockrxsEEErryz bach/bwv66.6r[r\r]r0r1r4)r^rYr_rrr`rarbrcrdrerfrgrhrr8) r)rYr_rvry timeCounterrirjrkrlrms rx_testBusyCallbackzTestExternal.x_testBusyCallbacks #"""""  H H H         dff !$  LL ( ( s 6 6A   V^^C44 5 5 5 5" 8 8A )!', 7AG   !__ [K=WZ[[[[[rcddlm}dt_|d}g}t |jdtj }t|D]*}| | |+t|}|D]}||_|dS)NrrXrZ)r^rYr ticksAtStartr`lenpartsgetElementsByClassrMeasurerarbmeasurerrr8)r)rYrimeasures maxMeasurerkrmrs rx_testPlayOneMeasureAtATimez(TestExternal.x_testPlayOneMeasureAtATimes"""""" ! LL # #66v~FFGG z"" * *A OOAIIaLL ) ) ) ) !__  G!BK GGIIII  rcFddlmddlfdfd}Gdd}|}}t|}||_|jdkr4d|_||j|||gd |jdk2dSdS) zf doesn't work -- no matter what there's always at least a small lag, even with queues r)noteNc,tj}tdD]F}}dd|_||G}|||S)N0H)rStreamraNotercpsrb)srkrllastNrr_s rgetRandomStreamz8TestExternal.x_testPlayRealTime..getRandomStreamsw A1XX  IIKK~~b"-- IIKKE HHUOOOHrc|d}|d}|jjj}|dcxkr |jkrznnw|xjdzc_|jdkrZ|_||_|jjj |j||_dSdS||_dS)Nrrz) r$r'rDget_poslastPosrqrr5 storedIOFilequeue)rtr| streamPlayer currentPosrs r restoreListz4TestExternal.x_testPlayRealTime..restoreList s"1+K#A;L%,28@@BBJC6666;#666666!!Q&!!$q((,;O,=,=L)/;/R/R/T/TK, '-399+:RSSS*4K''' )('1 ###rceZdZdZdZdZdS)3TestExternal.x_testPlayRealTime..TimePlayerFrAN)r rrreadyrqrrrr TimePlayerrsEEGGGrrFr]r{) r^rr_rr5rrqrr6) r)rrr|rirmrrr_s @@@rx_testPlayRealTimezTestExternal.x_testPlayRealTimes !             1 1 1 1 1         !jll O   !__#%#<#<#>#>  !## %K     8-8*5r):57  9 9 9!######r) r rrrloaderpygame_installedunittest skipUnlessrnr}rrrrrrVrVs Yx F  X)+DEE  FE ,\\\6   2929292929rrV__main__)rQ __future__rimportlib.utilriorrr^rmusic21.exceptions21rr music21.midir r;r rTestCaserTrVr mainTestrrrrs  #"""""$$$$$$111111333333     ,   E'E'E'E'E'E'E'E'P     8    y9y9y9y9y98$y9y9y9x zNNNG\"""""r