3j4#ddlmZddlZddlmZddlmZddlmZGddejZGdd Z Gd d ejZ e gZ e d k(rddlZeje yy) ) annotationsN)pitch) exceptions21) instrumentc eZdZy)MIDIPercussionExceptionN)__name__ __module__ __qualname__D/DATA/.local/lib/python3.12/site-packages/music21/midi/percussion.pyrrsr rceZdZdZeZidej dej dejdejdejdejdejd ejd ejd ejd ejd ejdejdejdejdejdejidejdejdejdejdejdejdejdej dej dej"dej"dej$dej&d ej&d!ej(d"ej(d#ej*d$ej*iZd%Zd&ZeegZy')(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:<=>?@ABCDFGHLMPQc$t|tr|}n |j}||jvrt |d|j|}|}|j dur0t |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 %"J"J T:: :)ZN:^*_` `66zB-/ , , 402KL1III/GG 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.midiInstrumentToPitchsT4~}59S9SW\9\)^,>>_*`a a"// kkm $ r N)r r r __doc__riBassDrum SnareDrumTomTom HiHatCymbal CrashCymbals TambourineCowbell Vibraslap BongoDrums CongaDrumTimbalesAgogoMaracasWhistle WoodblockTriangler9rBrG _DOC_ORDERr r rrrsl" A/ "AJJ/ " "AJJ/ " "AKK/ "!#AKK/ " !#AKK / " !#AHH / "!#AMM/ "!#AHH/ "!#AMM/ "!#AHH/ "!#AMM/ "!#AHH/ "!#AHH/ "!#ANN/ "!#AHH/ "&!#ALL'/ "*!#AII+/ ",!#ANN-/ ".!#AKK// "2!#ALL3/ "4!#ALL5/ "6!#AKK7/ "8!#AKK9/ ":!#AKK;/ "<!#AJJ=/ ">!#AJJ?/ "@!#AGGA/ "B!#AGGC/ "F!#AIIG/ "H!#AIII/ "J!#AIIK/ "R!#AKKS/ "T!#AKKU/ "Z!#AJJ[/ "\!#AJJ]/ "lC$JB()>?Jr rceZdZdZy)Testc2ddlm}||ty)Nr) testCopyAll)music21.test.commonTestr^globals)r=r^s rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys7D')$r N)r r r rar r rr\r\s%r r\__main__) __future__runittestmusic21rrrMusic21ExceptionrrTestCaser\rZr mainTestr r rrisu#  l;; o@o@d%8  %   zGTr