j4#ddlmZddlZddlmZddlmZddlmZGddejZGdd Z Gd d ej Z e gZ e d krddlZeje dSdS) ) annotationsN)pitch) exceptions21) instrumentceZdZdS)MIDIPercussionExceptionN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/midi/percussion.pyrrsDr rcdeZdZdZeZidejdejdejdejdejdejdej d ejd ej d ejd ej d ejdejdej dejdej dej idej dej dejdejdejdejdejdejdejdejdejdejdejd ejd!ejd"ejd#ejd$ejiZd%Zd&ZeegZd'S)(PercussionMapperaV PercussionMapper provides tools to convert between 0-indexed MIDI pitches and music21 instruments, based on the official General MIDI Level 1 Percussion Key Map. This mapping is conventionally applied to MIDI channel 10; see https://midi.org/general-midi-level-1 for more info. Give me the instrument that corresponds to MIDI note 58! >>> pm = midi.percussion.PercussionMapper() >>> pm.reverseInstrumentMapping[58] That's right, vibraslap. But you're better off using the midiPitchToInstrument() method below! #$%&()*+,-./012689:<=>?@ABCDFGHLMPQct|tr|}n|j}||jvrt |d|j|}|}|jdur-t |dr||jvr|j|}||_|S)a Takes a pitch.Pitch object or int ranging from 0-127 and returns the corresponding instrument in the GM Percussion Map. >>> pm = midi.percussion.PercussionMapper() >>> cowPitch = pitch.Pitch(56) >>> cowbell = pm.midiPitchToInstrument(cowPitch) >>> cowbell Or it can just take an integer (representing MIDI note) for the pitch instead: >>> moreCowbell = pm.midiPitchToInstrument(56) >>> moreCowbell The standard GM Percussion list goes from 35 to 81; pitches outside this range raise an exception. >>> bassDrum1Pitch = pitch.Pitch('B-1') >>> pm.midiPitchToInstrument(bassDrum1Pitch) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: 34 does not map to a valid instrument! Also, certain GM instruments do not have corresponding music21 instruments, so at present they also raise an exception. >>> cabasaPitch = 69 >>> pm.midiPitchToInstrument(cabasaPitch) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: 69 does not map to a valid instrument! Some music21 Instruments have more than one MidiPitch. In this case you'll get the same Instrument object but with a different modifier >>> acousticBassDrumPitch = pitch.Pitch(35) >>> acousticBDInstrument = pm.midiPitchToInstrument(acousticBassDrumPitch) >>> acousticBDInstrument >>> acousticBDInstrument.modifier 'acoustic' >>> oneBassDrumPitch = pitch.Pitch(36) >>> oneBDInstrument = pm.midiPitchToInstrument(oneBassDrumPitch) >>> oneBDInstrument >>> oneBDInstrument.modifier '1' z$ does not map to a valid instrument!T_percMapPitchToModifier) isinstanceintmidireverseInstrumentMappingr inGMPercMaphasattrr5modifier)self midiPitch midiNumbermidiInstrumentmidiInstrumentObjectr<s rmidiPitchToInstrumentz&PercussionMapper.midiPitchToInstrumentash i % % ("JJ"J T: : :)Z*_*_*_`` `6zB-~// , 4 402KLL 51III/G S08$-##r ct|dr |jdurt|d|j}t j}||_|S)a Takes an instrument.Instrument object and returns a pitch object with the corresponding 1-indexed MIDI note, according to the GM Percussion Map. >>> pm = midi.percussion.PercussionMapper() >>> myCow = instrument.Cowbell() >>> cowPitch = pm.midiInstrumentToPitch(myCow) >>> cowPitch.midi 56 Note that cowPitch is an actual pitch.Pitch object even though it's meaningless! >>> cowPitch If the instrument does not have an equivalent in the GM Percussion Map, return an Exception: >>> myBagpipes = instrument.Bagpipes() >>> pipePitch = pm.midiInstrumentToPitch(myBagpipes) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: is not in the GM Percussion Map! r:Fz! is not in the GM Percussion Map!)r;r:r percMapPitchrPitchr8)r=r@r> pitchObjects rmidiInstrumentToPitchz&PercussionMapper.midiInstrumentToPitchs]4~}55 b9SW\9\9\)^*`*`*`aa a"/ kmm $ r N)r r r __doc__riBassDrum SnareDrumTomTom HiHatCymbal CrashCymbals TambourineCowbell Vibraslap BongoDrums CongaDrumTimbalesAgogoMaracasWhistle WoodblockTriangler9rBrG _DOC_ORDERr r rrrs\" A/ "AJ/ " "AJ/ " "AK/ "!#AK/ " !#AK / " !#AH / "!#AM/ "!#AH/ "!#AM/ "!#AH/ "!#AM/ "!#AH/ "!#AH/ "!#AN/ "!#AH/ "&!#AL'/ "*!#AI+/ "/ ",!#AN-/ ".!#AK// "2!#AL3/ "4!#AL5/ "6!#AK7/ "8!#AK9/ ":!#AK;/ "<!#AJ=/ ">!#AJ?/ "@!#AGA/ "B!#AGC/ "F!#AIG/ "H!#AII/ "J!#AIK/ "R!#AKS/ "T!#AKU/ "Z!#AJ[/ "/ "\!#AJ]/ "/ "lC$C$C$JB()>?JJJr rceZdZdZdS)TestcBddlm}||tdS)Nr) testCopyAll)music21.test.commonTestr^globals)r=r^s rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys0777777 D'))$$$$$r N)r r r rar r rr\r\s#%%%%%r r\__main__) __future__runittestmusic21rrrMusic21ExceptionrrTestCaser\rZr mainTestr r rris,#"""""      l;   o@o@o@o@o@o@o@o@d%%%%%8 %%%   zNNNGTr