rh+SrSSKJr SSKJr SSKJr SSKrSSKJ r SSK J r SSKJ r SS K Jr "S S \ 5r"S S 5r"SS\R$5r"SS\R$5r\S:XaSSKr\R,"\5 gg)aq 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: pip3 install pygame ) annotations) find_spec)BytesION)defaults)Music21Exception)stream) translatec\rSrSrSrg)StreamPlayerException#N__name__ __module__ __qualname____firstlineno____static_attributes__r O/home/james-whalen/.local/lib/python3.13/site-packages/music21/midi/realtime.pyr r #rr c\rSrSrSrSrSSSjjrS\"S5SS.S jjrS r S\"S5SS.S jjr S r S r g) StreamPlayer'a 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) FcSSKnXplSSKnURUlUR SLdU(aURRX4XV5 Xl g![a [ S5ef=f)Nrz,StreamPlayer requires pygame. Install firstF) pygamepygame.exceptions exceptionspygame_exceptions ImportErrorr mixerInitializedmixerinitstreamIn)selfr# reinitMixer mixerFreq mixerBitSize mixerChannels mixerBufferrs r__init__StreamPlayer.__init__Msk X  K $%+%6%6D "  E )[ LL  i} R  X'(VW W Xs AA0NinfT)playForMillisecondsblockedc PUR5nURUUUUUUUUS9 g)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 rplayStreamPlayer.playds>*"88: 0+7'/*5&-3G2E&-  /rcx[R"UR5nUR5n[ U5$N) midiTranslatestreamToMidiFiler#writestrr)r$streamMidiFilestreamMidiWrittens rr5#StreamPlayer.getStringOrBytesIOFiles1&77 F*335())rcURRR5n URRRR U5 URRRR5 U(dg[SU- 5n URRR5n URRRR5(aUbU"U5 URRR5U - U:a/URRRR5 OFU RU 5 URRRR5(aMUb U"U5 gg!UR Ra1n [SUS3UR R5-5U eSn A ff=f)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)rtimeClockr!musicloadr PygameErrorr get_errorr8int get_ticksget_busystoptick) r$ stringIOFiler0r1r2r3r4r-r. pygameClockpge framerate start_times rr6StreamPlayer.playStringIOFiles kk&&,,.   KK   # # ( ( 6 $$& 334 [[%%//1 kk%%..00'X&{{))+j8;NN !!'',,.   Y ' kk%%..00  "   #%%%11 ',\N*E++5578:  s/F((G3,G..G3c`URRRR5 gr;)rr!rFrM)r$s rrMStreamPlayer.stops $$&r)rrr#)FiDii) r#z stream.Streamr%boolr&rJr'rJr(rJr)rJ)NNNN2) rrrr__doc__r r*floatr8r5r6rMrr rrrr's"F "!!! !  !  !!0"$ /"'u/>* JNNP&!.35\4&!P'rrc\rSrSrSrg)Testr Nrr rrr]r]rrr]cx\rSrSr\"S5r\bSrOSr\R"\S5S5r Sr S r S r S r g) TestExternalrNTFzpygame is not installedcjSSKJn SSKnURS5n/n[ S5H$nUR UR SS55 M& UR5RH*nXFRRURl M, [U5nUR5 g)Nrcorpusbwv66.6)music21rdrandomparserangeappendrandintrecursenotespitchmidi microtonerr8)r$rdrjb keyDetuneinsps rtestBachDetuneTestExternal.testBachDetunes" LL # sA   V^^C4 5""A )'',, 7AGG # !_  rcSSKJn SSKnSn"SS5nU"5nSUlUR S5n/n[ S 5H$nUR URS S 55 M& UR5RH*n XyRRU Rl M, [U5n U RX5/SS 9 g) z> tests to see if the busyCallback function is called properly rrcNc~USnU=RUR- sl[SURS35 g)Nrz hi! waited z milliseconds)times updateTimeprint)timeListtimeCounter_inners r busyCounter4TestExternal.x_testBusyCallback..busyCounters= (   # #'8'C'C C # K 1 7 78 F Grc\rSrSrSrSrg)-TestExternal.x_testBusyCallback..Mockrr N)rrrrr}rr rrMockrsErrz bach/bwv66.6rfrgrhr0r1r4)rirdrjr~rkrlrmrnrorprqrrrsrr8) r$rdrjrr timeCounterrtrurvrwrxs rx_testBusyCallbackTestExternal.x_testBusyCallbacks # H   f !$  LL ( sA   V^^C4 5""A )'',, 7AGG # !_ [=WZ[rcnSSKJn S[lUR S5n/n[ UR SR[R55n[U5H#nURURU55 M% [U5nUHnXvlUR5 M g)Nrrcre)rirdr ticksAtStartrklenpartsgetElementsByClassrMeasurerlrmmeasurerr#r8)r$rdrtmeasures maxMeasurervrxrs rx_testPlayOneMeasureAtATime(TestExternal.x_testPlayOneMeasureAtATimes" ! LL #66v~~FG z"A OOAIIaL )# !_G!K GGI rc6^^^SSKJm SSKmUU4SjmU4Sjn"SS5nU"5nT"5n[U5nUR 5UlUR S:a7SUlURUR UX5/S S 9 UR S:aM6gg) zV doesn't work -- no matter what there's always at least a small lag, even with queues r)noteNc>[R"5n[S5H;nTR5nTR SS5UlUR U5 M= TR5nUR U5 U$)N0H)rStreamrlNoternpsrm)srvrwlastNrrjs rgetRandomStream8TestExternal.x_testPlayRealTime..getRandomStreamsa A1XIIK~~b"- IIKE HHUOHrc>USnUSnURRRR5nUSs=:aUR::aO OU=R S-slUR S:aaT"5UlUR5UlURRRRUR5 X1lggX1lg)Nrr) rr!rFget_poslastPosr}r#r5 storedIOFilequeue)rr streamPlayer currentPosrs r restoreList4TestExternal.x_testPlayRealTime..restoreLists"1+K#A;L%,,2288@@BJC6;#6#66!!Q&!$$q(,;,=L)/;/R/R/TK, ''--3399+:R:RS*4' )'1#rc \rSrSrSrSrSrSrg)3TestExternal.x_testPlayRealTime..TimePlayeri#FrCr N)rrrrreadyr}rrr rr TimePlayerr#sEEGrrFrhr) rirrjrr5rr}rr6) r$rrrrtrxrrrjs @@@rx_testPlayRealTimeTestExternal.x_testPlayRealTimes !  1   !l   !_#%#<#<#>  !# %K     8 8-8*5):57  9!#rr )rrrrrloaderpygame_installedunittest skipUnlessryrrrrr rrr`r`sP x F   )+DE F ,\8 29rr`__main__)rZ __future__rimportlib.utilriorrrirmusic21.exceptions21rr music21.midir r<r rTestCaser]r`rmainTestr rrrs #$13 , J'J'Z 8   z98$$z9z z \"r