rhaSrSSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK JrJrJr SSKrSSKJr SSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJ r SSKJ!r! SSKJ"r" SSKJ#r# SSKJ$r$ SSKJ%r% SSKJ&r& SSKJ'r' SSKJ(r( SSKJ)r) SSKJ*r* SSKJ+r+ SSKJ,r, SSKJ-r- SSKJ.r. SS K/J0r0 SS!KJ1r1 SS"KJ2r2 SS#KJ3r3 SS$KJ4r4 SS%K5J6r6 SS&K7J8r8 SS'K5J9r9 SS(K:J;r; SS)K:J\6R~r@\6RrB\ R(aSS+KDJErE SS,KJFrF SS-KJGrG S?S.jrHS@S/jrISAS0jrJSBSS1S2.SCS3jjjrK"S4S55rL"S6S75rM"S8S9\M\85rN"S:S;\M5rO"S<S=\M5rP\QS>:XaSSKr\R"5 gg)Dz> Converters for music21 objects to musicxml using ElementTree ) annotations) OrderedDictN)Element SubElementComment) articulations)base)bar)clef)chord)common)AppendSpanners)opFrac)defaultsduration)dynamics) environment) exceptions21) expressions)harmony) instrument)key)layout)metadata)note)meter)pitch)prebase)repeat)spanner)stream)OffsetIterator)style)tempo)text)tie)helpers)PartStaffExporterMixin) xmlObjectsMusicXMLExportException)MusicXMLWarningzmusicxml.m21ToXml)OffsetQL)roman) tablaturecUS:XagUS:Xa [S5eUS:Xa [S5eUS:Xa [S5eUS :Xa [S 5eUS :Xa [S 5eU$) a Convert a music21 type to a MusicXML type or raise a MusicXMLExportException >>> musicxml.m21ToXml.typeToMusicXMLType('longa') 'long' >>> musicxml.m21ToXml.typeToMusicXMLType('quarter') 'quarter' >>> musicxml.m21ToXml.typeToMusicXMLType('duplex-maxima') Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Cannot convert "duplex-maxima" duration to MusicXML (too long). >>> musicxml.m21ToXml.typeToMusicXMLType('inexpressible') Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Cannot convert inexpressible durations to MusicXML. >>> musicxml.m21ToXml.typeToMusicXMLType('zero') Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Cannot convert durations without types to MusicXML. longalong2048thz9Cannot convert "2048th" duration to MusicXML (too short).z duplex-maximaz?Cannot convert "duplex-maxima" duration to MusicXML (too long). inexpressiblez3Cannot convert inexpressible durations to MusicXML.complexzyCannot convert complex durations to MusicXML. Try exporting with makeNotation=True or manually running splitAtDurations()zeroz3Cannot convert durations without types to MusicXML.r+)values S/home/james-whalen/.local/lib/python3.13/site-packages/music21/musicxml/m21ToXml.pytypeToMusicXMLTyper:Us,  ( %&abb / !% MO O / !%&[\\ ) % \] ] &%&[\\ cU(dgSU;a$[R"U5R5$UR5$)z Normalize a css3 name to hex or leave it alone. >>> musicxml.m21ToXml.normalizeColor('') '' >>> musicxml.m21ToXml.normalizeColor('red') '#FF0000' >>> musicxml.m21ToXml.normalizeColor('#00ff00') '#00FF00' #) webcolors name_to_hexupper)colors r9normalizeColorrC~s8  %$$U+1133{{}r;cURnUbU$UR5H2nURRcMURRs $ g)a Get metadata from site or context, so that a Part can be shown and have the rich metadata of its Score >>> s = stream.Score() >>> s2 = s.transpose(4) >>> md = metadata.Metadata() >>> md.title = 'emptiness' >>> s.metadata = md >>> s2.metadata is None True >>> musicxml.m21ToXml.getMetadataFromContext(s2).title 'emptiness' >>> musicxml.m21ToXml.getMetadataFromContext(s).title 'emptiness' >>> p = stream.Part() >>> s2.insert(0, p) >>> musicxml.m21ToXml.getMetadataFromContext(p).title 'emptiness' N)r contextSitessite)smd contextSites r9getMetadataFromContextrJsQ. B ~ ~~'    $ $ 0##,, ,( r;F) transform forceEmptycUc[R"U5n[X5nUbU"U5nUS;aUSLag[ X5nUb[ U5UlU$![a gf=f)a$ If m21El has an attribute called attributeName, create a new SubElement for xmlEl and set its text to the value of the m21El attribute. Pass a function or lambda function as transform to transform the value before setting it. String transformation is assumed. Returns the SubElement Will not create an empty element unless forceEmpty is True >>> from xml.etree.ElementTree import Element >>> e = Element('accidental') >>> seta = musicxml.m21ToXml._setTagTextFromAttribute >>> acc = pitch.Accidental() >>> acc.alter = -2.0 >>> subEl = seta(acc, e, 'alter') >>> subEl.text '-2.0' >>> subEl in e True >>> XB = musicxml.m21ToXml.XMLExporterBase() >>> XB.dump(e) -2.0 add a transform >>> subEl = seta(acc, e, 'alter', transform=int) >>> subEl.text '-2' NNr=T)r hyphenToCamelCasegetattrAttributeErrorrstrr&)m21ElxmlEltag attributeNamerKrLr8 subElements r9_setTagTextFromAttributerXs\005 -%  z5E'J e*   s A A*)A*c\rSrSrSr\"/SQ5rSSSjjrSSSjjrSSjr SSjr S r S r S r S rS rSrSrSrSrSrSrSSjrSrg)GeneralObjectExporterzh Packs any `Music21Object` into a well-formed score and exports a bytes object MusicXML representation. ) )Score fromScore)PartfromPart)Measure fromMeasure)Voice fromVoice)Stream fromStream) GeneralNotefromGeneralNote)Pitch fromPitch)Duration fromDuration)Dynamic fromDynamic) DiatonicScalefromDiatonicScale)Scale fromScale) Music21ObjectfromMusic21ObjectNcXlSUlgNT generalObj makeNotation)selfobjs r9__init__GeneralObjectExporter.__init__ s"&r;cUc URnUc [S5eUR(a"URU5nUR U5$[ U[ R5(d [S5eUR U5$)a Return a bytes object representation of anything from a Score to a single pitch. When :attr:`makeNotation` is True (default), wraps `obj` in a well-formed `Score`, makes a copy, and runs :meth:`~music21.stream.base.Stream.makeNotation` on each of the parts. To skip copying and making notation, set `.makeNotation` on this instance to False. >>> p = pitch.Pitch('D#4') >>> GEX = musicxml.m21ToXml.GeneralObjectExporter(p) >>> out = GEX.parse() # out is bytes >>> outStr = out.decode('utf-8') # now is string >>> print(outStr.strip()) Music21 Fragment Music21 ... music21 v... 7 40 10080 G 2 D 1 4 10080 quarter sharp zMust have an object to exportz.Can only export Scores with makeNotation=False)rwr,rxfromGeneralObjectparseWellformedObject isinstancer"r\)ryrzoutObjs r9parseGeneralObjectExporter.parses|H ;//C ;)*IJ J   ++C0F--f5 5c6<<00-.^__--c2 2r;ch[XRS9nUR5 UR5$)z Parse an object that has already gone through the `.fromGeneralObject` conversion, which has produced a copy with :meth:`~music21.stream.Score.makeNotation` run on it (unless :attr:`makeNotation` is False). Returns bytes. )rx) ScoreExporterrxrasBytes)rysc scoreExporters r9r+GeneralObjectExporter.parseWellformedObject`s/&b7H7HI $$&&r;cvURnSn[U[R5(a0UR(aUR SUR /SSSSS9nURR5HupEXB;dM [X5nU"U5n O Uc[SURS3-5eU$)a? Converts any Music21Object (or a duration or a pitch) to something that can be passed to :class:`ScoreExporter`. >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> s = GEX.fromGeneralObject(duration.Duration(3.0)) >>> s >>> s.show('t') {0.0} {0.0} {0.0} {0.0} {0.0} {3.0} >>> s[note.NotRest].first().duration * Changed in v8: fills gaps with rests before calling makeNotation to avoid duplicating effort with :meth:`PartExporter.fixupNotationMeasured`. >>> v = stream.Voice(note.Note()) >>> m = stream.Measure([meter.TimeSignature(), v]) >>> GEX = musicxml.m21ToXml.GeneralObjectExporter(m) >>> out = GEX.parse() # out is bytes >>> outStr = out.decode('utf-8') # now is string >>> '' in outStr True >>> len(v[note.Rest]) # original stream unchanged 0 NTF)refStreamOrTimeRangefillGapsinPlace hideReststimeRangeFromBarDurationzCannot translate the object z; to a complete musicXML document; put it in a Stream first!) classesrr"rdrx makeRests highestTime classMappingitemsrPr,rw)ryrzrrcMmethNamemeths r9r~'GeneralObjectExporter.fromGeneralObjectms@++ c6== ) )d.?.?--c3??5K)-(-*.9=  "C!--335LB}t.c 6 >).__%%`ab  r;cUR(aURSS9 UR5(d[R"US3[S9 U$)z> Runs :meth:`~music21.stream.Score.makeNotation` on the copy. Trz/ is not well-formed; see isWellFormedNotation())category)rxisWellFormedNotationwarningswarnr-)ryrs r9r]GeneralObjectExporter.fromScoresJ    OODO )&&(( MMRD OP( * r;cUR(aURSS9 [R"5nUR SU5 [ R "[U55UlURU5$)z% From a part, put it in a new score. Trr) isFlat makeMeasuresr"r\insertcopydeepcopyrJrr])ryprGs r9r_GeneralObjectExporter.fromPartsV 88 NN4N ( LLN A]]#9!#<= ~~a  r;cUR5 URSS9 URRcSURlUR [ R [RRRS9nUc[ R"USS9UlOX!l[R"5nURU5 [R "[#U55UlUR [R5nUb"UR&UlUR(UlUR+U5$)z Translate a music21 Measure into a complete MusicXML string representation. Note: this method is called for complete MusicXML representation of a Measure, not for partial solutions in Part or Stream production. Trmeasure)getElementMethodrecurse)coreGatherMissingSpannersrxr$measureNumberinggetContextByClassr Clefr enums ElementSearchAT_OR_BEFORE_OFFSETbestClefr"r^appendrrrJrpartNamepartAbbreviationr_)rym"clef_from_measure_start_or_contextr context_parts r9ra!GeneralObjectExporter.fromMeasures ##% t$ 77 # # +'0AGG $-.-@-@ II#\\77KK.A. * . 5]]1d3AF7F KKM  ]]#9!#<= **6;;7  #%..AJ!-!>!>A }}Qr;cp[R"SS9nURSU5 URU5$)Nnumberr)r"r`rra)ryvrs r9rcGeneralObjectExporter.fromVoices. NN! $ A""r;cUR(a[R"5nURU5 [R "U5UlUR[R5RS5(d[R"U5UlURSS9 [R "[U55UlURU5$UR!5(a[R""5nURU5 [R "U5UlURSS9 [R "[U55UlUR%U5$UR[R&5R)5R(a[R"5nURU5 [R "U5UlUR[R5RS5(dSnOSnURSUS9 [R "[U55UlURU5$UR[R5RS5(dSnOSnURSUS9nUR%U5$)NrTrF)rr)rr"r^mergeAttributesrrelementsgetElementsByClassr rgetElementsByOffsetrrxrJrr_hasPartLikeStreamsr\r]rdfirst)rystst2rs r9re GeneralObjectExporter.fromStreams 99++-C    #==,CL((3GGLL==-   T  *==)?)CDCL==% %  " " $ $,,.C    #==,CL   T  *==)?)CDCL>>#& &  " "6== 1 7 7 9 @ @++-C    #==,CL((3GGLL    TH  ===)?)CDCL==% %((3GGLL //%(/CC>>"% %r;c[R"U5n[R"5nX#lUR U5$)z Translate a music21 :class:`~music21.duration.Duration` into a complete MusicXML representation. Rarely, rarely used. Only if you call .show() on a duration object )rrrNoterrg)ryddCopyns r9rk"GeneralObjectExporter.fromDuration s3 a  IIK ##A&&r;c[R"U5n[R"5nUR U5 UR U5$)z^ Provide a complete MusicXML string from a single dynamic by putting it into a Stream first. )rrr"rdrre)ry dynamicObjectrouts r9rm!GeneralObjectExporter.fromDynamics8  m,mmo 5s##r;c[R"SS9n[SURR 5S-5HnUR U5n[ R"5nXElUS:XaURUR5 URUR5R:XaSUl OSUl URU5 M UR5UlUR!U5$)a Generate the pitches from this scale and put it into a stream.Measure, then call fromMeasure on it. >>> cMaj = scale.MajorScale('C') >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> m = GEX.fromScale(cMaj) >>> m >>> m.show('text') {0.0} {0.0} {0.0} {0.0} {0.0} {4.0} {5.0} {6.0} {7.0} {8.0} {9.0} rr)r"r`rangeabstractgetDegreeMaxUniquepitchFromDegreerrraddLyricnamegetTonic quarterLengthrbestTimeSignature timeSignaturera)ry scaleObjectrirrs r9rqGeneralObjectExporter.fromScale%s4 NN! $q+..AACaGHA++A.A AGAv ;++,vv--/444"#"# HHQKI--/""r;c\[R"SS9n[SURR 5S-5HnUR U5n[ R"5nXElUS:XaURUR5 URUR5R:XaSUl O7URUR5R:XaSUl OSUl URU5 M UR5UlUR#U5$)a Return a complete musicxml of the DiatonicScale Overrides the general scale behavior to highlight the tonic and dominant. >>> cMaj = scale.MajorScale('C') >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> m = GEX.fromDiatonicScale(cMaj) >>> m >>> m.show('text') {0.0} {0.0} {0.0} {0.0} {0.0} {4.0} {5.0} {6.0} {7.0} {9.0} {10.0} rrr)r"r`rrrrrrrrrrr getDominantrrrra)rydiatonicScaleObjectrrrrs r9ro'GeneralObjectExporter.fromDiatonicScaleOs6 NN! $q-66IIKaOPA#33A6A AGAv .334vv,557<<<"#.::<AAA"#"# HHQKQ--/""r;c[R"U5n[R"SS9nUR U5 UR U5$)z6 return a single TimeSignature as a musicxml document rr)rrr"r`rra)ryrzobjCopyrs r9rs'GeneralObjectExporter.fromMusic21Object|s? --$nnA& 7$$r;c[R"U5n[R"U5nSURs=:aS::a)O O&UR S[ R"U55 [RRUSSUR/S9 [RRUSS9 URU5$)ay Translate a music21 :class:`~music21.note.Note` into an object ready to be parsed. An attempt is made to find the best TimeSignature for quarterLengths <= 6: >>> n = note.Note('c3') >>> n.quarterLength = 3 >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> sc = GEX.fromGeneralNote(n) >>> sc.show('t') {0.0} {0.0} {0.0} {0.0} {0.0} {3.0} But longer notes will be broken into tied components placed in 4/4 measures: >>> long_note = note.Note('e5', quarterLength=40) >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> sc = GEX.fromGeneralNote(long_note) >>> sc[meter.TimeSignature].first() >>> len(sc[stream.Measure]) 10 rg@T)rrr) rrr"r^rrrrrxrmakeTupletBracketsr_)ryrnCopynew_parts r9rg%GeneralObjectExporter.fromGeneralNotesD a ;;u% q %# % OOAu66x@ A(( "#U%8%8!9 ) ..x.F}}X&&r;c[R"5n[R"U5Ul[ R "SS9nURU5 URU5$)a Translate a music21 :class:`~music21.pitch.Pitch` into an object ready to be parsed. >>> p = pitch.Pitch('c#3') >>> GEX = musicxml.m21ToXml.GeneralObjectExporter() >>> sc = GEX.fromPitch(p) >>> sc.show('t') {0.0} {0.0} {0.0} {0.0} {0.0} rr) rrrrrr"r`rra)ryrrrs r9riGeneralObjectExporter.fromPitchsI IIK--"nnA& 1 $$r;rvN)rzprebase.ProtoM21Object | None)rzrreturnbytes)rz stream.Scorerr)rzzprebase.ProtoM21Objectrz pitch.Pitch)__name__ __module__ __qualname____firstlineno____doc__rrr{rrr~r]r_rarcrerkrmrqrorsrgri__static_attributes__r;r9rZrZso L 'O3b '6p  ! ># &&P' $(#T+#Z %,'\%r;rZc\rSrSrSrSSjrSSSjjrSS Sjjr\S5r SSjr S!S jr S r S r S rS rSrSrSrSrS!SjrS!SjrS!SjrS!SjrS!SjrSS.S"SjjrS#SjrSrg)$XMLExporterBaseiza contains functions that could be called at multiple levels of exporting (Score, Part, Measure). cX[S5Ul[R"5Ulg)Nzoverride-me-in-subclasses)rxmlRootr"rdrys r9r{XMLExporterBase.__init__s:; %+]]_ r;c.[R"5nURUR55 URn[ R "X1S9nURURS55 UR5nUR5 U$)z returns the xmlRoot as a bytes object. If noCopy is True (default), modifies the file for pretty-printing in place. Otherwise, make a copy. )noCopyutf-8) ioBytesIOwrite xmlHeaderrr( dumpStringencodegetvalueclose)ryrsiorootObjrootObj_stringrs r9rXMLExporterBase.asBytessk jjl $.."#,, ++GC .''01 LLN r;c[[U5S5n[R"SU- S- 5n[R"SU- S- 5nSU-S-U-S-SU--n[ U5nUR RU5 g)a Add a divider to xmlRoot. >>> from xml.etree.ElementTree import Element >>> e1 = Element('accidental') >>> e2 = Element('accidental') >>> XB = musicxml.m21ToXml.ScoreExporter() >>> XB.xmlRoot.append(e1) >>> XB.addDividerComment('second accidental below') >>> XB.xmlRoot.append(e2) >>> XB.dump(XB.xmlRoot) <r= N)minlenmathfloorceilrrr)rycomment commentLengthspacerLengthLowspacerLengthHigh commentTextdividers r9addDividerComment!XMLExporterBase.addDividerComments&CL"- **b=&8A%=>99b=&8A%=>_,3g=CsM]G]^ +& G$r;c.[R"U5$r)r(dump)rzs r9r(XMLExporterBase.dumps||C  r;cRS[RRS5-S-S-$)Nsd )rmusicxmlVersionrrs r9r XMLExporterBase.xmlHeaders<=**11':;))H H Ir;Nc.[U[R5(aUnOURSLagURn[R "U5(dU4nUc SU5nO[R "U5(dU4n[ X45H]upg[XW5nU[R;a[R"U5nUcM@[U5nURXh5 M_ g![a Mof=f![a Mf=f)zm Sets any attribute from .style, doing some conversions. m21Object can also be a style.Style object itself. FNc3N# UHn[R"U5v M g7fr)r rO).0xs r9 5XMLExporterBase.setStyleAttributes.."sK]0033]s#%)rr$StylehasStyleInformationr isIterableziprPrQr*STYLE_ATTRIBUTES_YES_NO_TO_BOOLbooleanToYesNorR ValueErrorset) rymxObject m21Object musicXMLNamesm21NamesstObjxmlNamem21Namem21Values r9setStyleAttributes"XMLExporterBase.setStyleAttributess i - -E  * *e 3 OOE  //*,M  K]KH""8,, {H #M < G "52*DDD%44X> x= LL +#!="    s$ C5 D5 DD DDcRSnSnURXX45 URX5 g)a< sets the justification, print-style-align group, and text-decoration, text-rotation, letter-spacing, line-height, lang, text-direction, and enclosure, on an m21Object, which must have style.TextStyle as its Style class, and then calls setPrintStyleAlign conforms to attr-group %text-formatting in the MusicXML DTD )justifyztext-decorationz text-rotationzletter-spacingz line-heightlangztext-direction enclosure)rFtextDecoration textRotation letterSpacing lineHeightlanguage textDirectionrHN)rCsetPrintStyleAlignryr;r<r=r>s r9setTextFormatting!XMLExporterBase.setTextFormatting9s0O L ]M 4r;cNURX5 URUUSS5 g)z runs setPrintStyle and then sets horizontalAlign and verticalAlign, on an m21Object, which must have style.TextStyle as its Style class. conforms to attr-group %print-style-align in the MusicXML DTD )valignhalign) alignVerticalalignHorizontalN) setPrintStylerCryr;r<s r9rO"XMLExporterBase.setPrintStyleAlignKs, 8/  ) 4 D Fr;cjURX5 URX5 URX5 g)z get position, font, and color information from the mxObject into the m21Object, which must have style.TextStyle as its Style class. conforms to attr-group %print-style in the MusicXML DTD N) setPositionsetFontsetColorrYs r9rXXMLExporterBase.setPrintStyleXs* - X) h*r;c[U[R5(aUnOUR(a URnOgUR(aUR SS5 gg)z sets print-object to 'no' if m21Object.style.hideObjectOnPrint is True or if m21Object is a StyleObject and has .hideObjectOnPrint set to True. N print-objectno)rr$r3r4hideObjectOnPrintr:)ryr;r<rs r9setPrintObjectXMLExporterBase.setPrintObjectcsK i - -B  * *B    LL . r;cURXSS5 SUR;a&[URS5URS'gg)zI Sets mxObject['color'] to a normalized version of m21Object.style.color rBN)rCattribrCrYs r9r^XMLExporterBase.setColorrsC WgF hoo %'5hoog6N'OHOOG $ &r;cSnSnURXX45 [U[R5(aUnOUR(a URnOg[ US5(asUR S:Xa/URSS5 URRSS5 O4UR S:Xa$URSS5 URSS 5 [ US 5(aUR(an[R"UR5(a,URS S RUR55 gURS UR5 ggg) a sets font-family, font-style, font-size, and font-weight as fontFamily (list), fontStyle, fontSize and fontWeight from an object into a TextStyle object conforms to attr-group %font in the MusicXML DTD >>> from xml.etree.ElementTree import fromstring as El >>> XB = musicxml.m21ToXml.XMLExporterBase() >>> mxObj = El('hi') >>> te = expressions.TextExpression('hi!') >>> te.style.fontFamily = ['Courier', 'monospaced'] >>> te.style.fontStyle = 'italic' >>> te.style.fontSize = 24.0 >>> XB.setFont(mxObj, te) >>> XB.dump(mxObj) hi >>> XB = musicxml.m21ToXml.XMLExporterBase() >>> mxObj = El('hi') >>> te = expressions.TextExpression('hi!') >>> te.style.fontStyle = 'bold' >>> XB.setFont(mxObj, te) >>> XB.dump(mxObj) hi >>> te.style.fontStyle = 'bolditalic' >>> XB.setFont(mxObj, te) >>> XB.dump(mxObj) hi ) font-stylez font-size font-weight) fontStylefontSize fontWeightNrlboldrkrj bolditalicitalic fontFamilyz font-family,)rCrr$r3r4hasattrrlr:rgpoprrr r5join)ryr;r<r=r>rs r9r]XMLExporterBase.setFont}s @C : ]M i - -B  * *B  2{ # #||v% ]F3##L$7- ]F3 \84 2| $ $  // ]CHHR]],CD ]BMM: *7 $r;c0SnSnURXX45 g)z set positioning information for an mxObject from default-x, default-y, relative-x, relative-y from the .style attribute's absoluteX, relativeX, etc. attributes. )z default-xz default-yz relative-xz relative-y) absoluteX absoluteY relativeX relativeYNrCrPs r9r\XMLExporterBase.setPositions O G ]Mr;c0URSLagURnSU;aSU;agSnUR(aURSnSnO"UR(aURSnOgU(a;[ US5nUR Xe5 UR bUR UlURbW[ US5n[UR5UlURS [R"UR55 gg) a >>> from xml.etree.ElementTree import fromstring as El >>> XB = musicxml.m21ToXml.XMLExporterBase() >>> mxObj = El('') >>> n = note.Note('C-5') Most common case: does nothing >>> XB.setEditorial(mxObj, n) >>> XB.dump(mxObj) >>> fn = editorial.Comment('flat is obvious error for sharp') >>> fn.levelInformation = 2 >>> fn.isFootnote = True >>> n.editorial.footnotes.append(fn) >>> XB.setEditorial(mxObj, n) >>> XB.dump(mxObj) flat is obvious error for sharp 2 Placing information in `.editorial.comments` only puts out the level: >>> mxObj = El('') >>> n = note.Note('C-5') >>> com = editorial.Comment('flat is obvious error for sharp') >>> com.levelInformation = 'hello' >>> com.isReference = True >>> n.editorial.comments.append(com) >>> XB.setEditorial(mxObj, n) >>> XB.dump(mxObj) hello FN footnotescommentsrTfootnotelevel reference) hasEditorialInformation editorialrrrrQr&levelInformationrRr:r*r8 isReference)ryr;r<e makeFootnotecmxFnmxLevels r9 setEditorialXMLExporterBase.setEditorialsL  , , 5     a Ja$7  ;; AAL ZZ 1 A  h 3D  " "4 +vv!FF   ) 73Gq112GL KK Z%>%>q}}%M N *r;cUc [S5nOUn[nU"XSS[RS9 U"XS5 UR U5n[ U5(aUR U5 UcU$g)a Given a PageLayout object, set object data for >>> pl = layout.PageLayout() >>> pl.pageHeight = 4000 >>> pl.isNew = True >>> pl.rightMargin = 30.25 >>> pl.leftMargin = 20 >>> pl.pageNumber = 5 >>> XPBase = musicxml.m21ToXml.XMLExporterBase() >>> mxPrint = XPBase.pageLayoutToXmlPrint(pl) >>> XPBase.dump(mxPrint) 4000 20 30.25 >>> MP = musicxml.xmlToM21.MeasureParser() >>> pl2 = MP.xmlPrintToPageLayout(mxPrint) >>> pl2.isNew True >>> pl2.rightMargin 30.25 >>> pl2.leftMargin 20 >>> pl2.pageNumber 5 >>> pl2.pageHeight 4000 Nprintnew-pageisNewrKz page-number)rsetAttributeFromAttributer*r8pageLayoutToXmlPageLayoutrr)ry pageLayout mxPrintInmxPrintsetb mxPageLayouts r9pageLayoutToXmlPrint$XMLExporterBase.pageLayoutToXmlPrintstN  g&GG( Z*gAZAZ[ Z-055jA |   NN< (  N r;cUc [S5nOUn[nU"XS5 U"XS5 [S5nSHnU"XUS-5 M [U5(aURU5 UcU$g)z get a element from a PageLayout Called out from pageLayoutToXmlPrint because it is also used in the tag Nz page-layoutz page-heightz page-widthz page-margins)leftrighttopbottom-marginrrXrr)ryrmxPageLayoutInrseta mxPageMargins directions r9r)XMLExporterBase.pageLayoutToXmlPageLayout=s  !"=1L)L' Z}5 Z|4 / ;I I ,A B< }      .  !  "r;cUc [S5nOUn[nU"XSS[RS9 [S5nUR X5 [ U5(aUR U5 UcU$g)a Given a SystemLayout tag, set a tag >>> sl = layout.SystemLayout() >>> sl.distance = 55 >>> sl.isNew = True >>> sl.rightMargin = 30.25 >>> sl.leftMargin = 20 >>> XPBase = musicxml.m21ToXml.XMLExporterBase() >>> mxPrint = XPBase.systemLayoutToXmlPrint(sl) >>> XPBase.dump(mxPrint) 20 30.25 55 Test return conversion >>> MP = musicxml.xmlToM21.MeasureParser() >>> sl2 = MP.xmlPrintToSystemLayout(mxPrint) >>> sl2.isNew True >>> sl2.rightMargin 30.25 >>> sl2.leftMargin 20 >>> sl2.distance 55 Nr new-systemrr system-layout)rrr*r8systemLayoutToXmlSystemLayoutrr)ry systemLayoutrrrmxSystemLayouts r9systemLayoutToXmlPrint&XMLExporterBase.systemLayoutToXmlPrintXsrL  g&GG( \L'ZE^E^_ 1 **<H ~   NN> *  N r;cUc [S5nOUn[n[S5nSHnU"XUS-5 M [U5(aURU5 U"XSS5 U"XSS 5 UcU$g) a get given a SystemLayout object configure or Called out from xmlPrintToSystemLayout because it is also used in the tag >>> sl = layout.SystemLayout() >>> sl.distance = 40.0 >>> sl.topDistance = 70.0 >>> XPBase = musicxml.m21ToXml.XMLExporterBase() >>> mxSl = XPBase.systemLayoutToXmlSystemLayout(sl) >>> XPBase.dump(mxSl) 40.0 70.0 >>> sl = layout.SystemLayout() >>> sl.leftMargin = 30.0 >>> mxSl = XPBase.systemLayoutToXmlSystemLayout(sl) >>> XPBase.dump(mxSl) 30.0 Nrzsystem-margins)rrrrrzsystem-distancedistanceztop-system-distance topDistancer)ryrmxSystemLayoutInrrmxSystemMarginsrs r9r-XMLExporterBase.systemLayoutToXmlSystemLayouts8  #$_5N-N'""23;I  I0E F<     ! !/ 2 \+ tag from a StaffLayout object In music21, the and are intertwined in a StaffLayout object. >>> sl = layout.StaffLayout() >>> sl.distance = 40.0 >>> sl.staffNumber = 1 >>> XPBase = musicxml.m21ToXml.XMLExporterBase() >>> mxSl = XPBase.staffLayoutToXmlStaffLayout(sl) >>> XPBase.dump(mxSl) 40.0 Nz staff-layoutzstaff-distancerr staffNumber)rrXr)ry staffLayoutmxStaffLayoutIn mxStaffLayoutrrs r9staffLayoutToXmlStaffLayout+XMLExporterBase.staffLayoutToXmlStaffLayoutsM$  "#N3M+M'( [)9:F [=A  "  #r; accidentalelNamecSnURS:XaSnOsURS:XaSnO`URS:XaSnOMURS:XaS nO:URS :XaS nO'URnU[R;aXC;aS n[U5nXElUR S ;aUR SS5 UR S;aUR SS5 URXQ5 U$)a Convert a pitch.Accidental object to a Element of tag 'accidental' (or other name) >>> acc = pitch.Accidental() >>> acc.set('half-sharp') >>> acc.alter == 0.5 True >>> XB = musicxml.m21ToXml.XMLExporterBase() >>> a2m = XB.accidentalToMx >>> XB.dump(a2m(acc)) quarter-sharp >>> acc.set('double-flat') >>> XB.dump(a2m(acc)) flat-flat >>> acc.set('one-and-a-half-sharp') >>> XB.dump(a2m(acc, elName='accidental-mark')) three-quarters-sharp >>> acc.set('half-flat') >>> XB.dump(a2m(acc)) quarter-flat >>> acc.set('one-and-a-half-flat') >>> XB.dump(a2m(acc)) three-quarters-flat >>> acc.set('sharp') >>> acc.displayStyle = 'parentheses' >>> XB.dump(a2m(acc)) sharp >>> acc.displayStyle = 'bracket' >>> XB.dump(a2m(acc)) sharp >>> acc.displayStyle = 'both' >>> XB.dump(a2m(acc)) sharp >>> acc = pitch.Accidental('flat') >>> acc.style.relativeX = -2 >>> XB.dump(a2m(acc)) flat >>> acc = pitch.Accidental() >>> acc.name = 'double-sharp-down' # musicxml 3.1 >>> XB.dump(a2m(acc)) double-sharp-down >>> acc.name = 'funnyAccidental' # unknown >>> XB.dump(a2m(acc)) other )zdouble-sharp-downzdouble-sharp-upzflat-flat-downz flat-flat-upz arrow-downzarrow-upotherz sharp-downzsharp-upz natural-downz natural-upz flat-downzflat-upzslash-quarter-sharpz slash-sharpz slash-flatzdouble-slash-flatzsharp-1zsharp-2zsharp-3zsharp-5zflat-1zflat-2zflat-3zflat-4sorikoronz half-sharpz quarter-sharpzone-and-a-half-sharpzthree-quarters-sharpz half-flatz quarter-flatzone-and-a-half-flatzthree-quarters-flatz double-flatz flat-flatr) parenthesesbothryes)bracketrr)rraccidentalNameToModifierrr& displayStyler:rX)ryarotherMusicXMLAccidentalsmxName mxAccidentals r9accidentalToMxXMLExporterBase.accidentalToMxsv$  ( 66\ !$F VV- -+F VV{ "#F VV, ,*F VV} $ FVVFe<<<> v # >>4 4   ]E 2 >>0 0   Y . <+r;c"URUSS9$)Nzaccidental-markr)r)ryrs r9accidentalToMxAccidentalMark,XMLExporterBase.accidentalToMxAccidentalMarkNs""1->"??r;)r"rrNone)T)rr)r=)rrRrrr)rpitch.AccidentalrrRrr)rrrr)rrrrrr{rr% staticmethodr(r rCrQrOrXrdr^r]r\rrrrrrrrrrr;r9rrs5 %:!!I&,P5$ F + / P7;rN?OL5n 64l1"f!@DPjZ@r;rc^\rSrSrSrSSU4SjjjrS SjrS SjrS!SjrS!Sjr S!Sjr S!S jr S!S jr S!S jr S!S jrS!S jrS!SjrS!SjrS!SjrS"SjrSrSrSrSrSrS SjrS#S$SjjrSrSrS!SjrSrSrU=r $)%riTzH Convert a Score (or outer stream with .parts) into a musicxml Element. c>[TU]5 Uc[R"5UlOXl[ S[ R S9UlSUlSUl SUl SUl /Ul SUl /UlSUlSUR/Ul/Ul/Ul0Ul/Ul/Ul/Ul/UlX lg)Nzscore-partwise)versionr)superr{r"r\rrr+rmxIdentification scoreMetadata spannerBundle meterStream scoreLayoutsfirstScoreLayout textBoxesrrpartExporterList groupsToJoininstrumentsByStreaminstrumentListinstrumentIdListmidiChannelListpartsrx)ryscorerx __class__s r9r{ScoreExporter.__init__Zs  = ,,.DKK/9Q9QR .2599=HL689=-/%($*:*:$;!4657=? ;=02/1(* ".r;cURnU(dUR5$URSSS9 UR5 UR 5(aVUR 5 UR 5UlUR5 UR5 UR5 OUR5 UR5 URR5 UR$)a the main function to call. If self.stream is empty, call self.emptyObject(). Otherwise, convert sounding to written pitch, set scorePreliminaries(), call parsePartlikeScore or parseFlatScore, then postPartProcess(), clean up circular references for garbage collection, and returns the object. >>> b = corpus.parse('bwv66.6') >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> mxScore = SX.parse() >>> SX.dump(mxScore) ... TrottavasToSounding)r" emptyObjecttoWrittenPitchscorePreliminariesr_populatePartExporterListjoinableGroupsrsetPartExporterStaffGroupsrenumberVoicesWithinStaffGroupsparsePartlikeScoreparseFlatScorepostPartProcessrclearr)ryrGs r9rScoreExporter.parse~s KK##% % > !   ! !  * * , $ 3 3 5D   + + -  0 0 2  # # %    !  ##%||r;c[R"5n[R"5n[R"5n[R "SS9nUR U5 UR U5 UR U5 [R"SS9nURSU5 XlUR5$)a Creates a cheeky "This Page Intentionally Left Blank" for a blank score >>> emptySX = musicxml.m21ToXml.ScoreExporter() >>> mxScore = emptySX.parse() # will call emptyObject >>> emptySX.dump(mxScore) This Page Intentionally Left Blank ... 40320 whole r)rz"This Page Intentionally Left Blank)titler) r"r\r^r`rRestrrMetadatarr)ryrrrrrHs r9rScoreExporter.emptyObjects*lln KKM NN  IIA &     1   %I J 1b zz|r;cUR5 UR5 UR5 [UR[ R 5UlSUlURcURRUl gg)a0 Populate the exporter object with `meterStream`, `scoreLayouts`, `spannerBundle`, and `textBoxes` >>> emptySX = musicxml.m21ToXml.ScoreExporter() >>> emptySX.scorePreliminaries() # will call emptyObject >>> len(emptySX.textBoxes) 0 >>> emptySX.spannerBundle rN) setScoreLayoutssetMeterStreamsetPartsAndRefStreamlistr"r&TextBoxrrrrs r9r ScoreExporter.scorePreliminariessn   !!#dkk$,,78    %!%!:!:D  &r;cURn[R(a![U[R5(deUR [R 5nUHn[U[R5(aURUR-nOV[U[R[R45(a [S5eUR5 URn[URU5Ul M SUR/Ul[UR 5Ulg)aK Transfers the offset of the inner stream to elements and sets self.highestTime >>> b = corpus.parse('bwv66.6') >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> SX.highestTime 0.0 >>> SX.setPartsAndRefStream() >>> SX.highestTime 36.0 >>> SX.refStreamOrTimeRange [0.0, 36.0] >>> len(SX.parts) 4 >>> isinstance(SX.parts[0], stream.Part) True >>> b.insert(stream.Score()) >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> SX.setPartsAndRefStream() Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Exporting scores nested inside scores is not supported z6Exporting scores nested inside scores is not supportedrN)r"t TYPE_CHECKINGrr\rrdr`offsetrOpusr,transferOffsetToElementsmaxrrr)ryrGstreamOfStreams innerStreamhts r9r"ScoreExporter.setPartsAndRefStreams2 KK ??a.. ....v}}=*K +v~~66 ''+*A*AAK&,, )DEE-LNN446 ,,"4#3#3R8D +&)$*:*:$;!!''] r;cJURnURSSSS9nX lg)aC sets `self.meterStream` or uses a default. Used in makeNotation in Part later. >>> b = corpus.parse('bwv66.6') >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> SX.setMeterStream() >>> SX.meterStream >>> len(SX.meterStream) 4 >>> SX.meterStream[0] FT) searchContextsortByCreationTime returnDefaultN)r"getTimeSignaturesr)ryrGrs r9rScoreExporter.setMeterStreams2 KK))=B8<*> 'r;cURnUR[R5nUR 5Ul[ U5Ulg)a, sets `self.scoreLayouts` and `self.firstScoreLayout` >>> b = corpus.parse('schoenberg/opus19', 2) >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> SX.setScoreLayouts() >>> SX.scoreLayouts [] >>> len(SX.scoreLayouts) 1 >>> SX.firstScoreLayout N)r"rr ScoreLayoutrrrr)ryrGrs r9rScoreExporter.setScoreLayouts+sA KK++F,>,>? , 2 2 4 .r;cSn[UR5nUHWnUS- nU[U5:a [S5e[ X0S9nUR UlUR RU5 MY g)Nrrzinfinite stream encounteredparent)rrrr, PartExporterrrr)rycountsprpps r9r'ScoreExporter._populatePartExporterList>sm $** K QJEs2w-.KLLk7B#11B   ! ! ( ( ,r;cUR(dUR5 URHnUR5 M g)z Called by .parse() if the score has individual parts. Creates a `PartExporter` for each part, and runs .parse() on that part. Appends the PartExporter to `self.partExporterList` and runs .parse() on that part. Appends the PartExporter to self. N)rrr)rypart_exs r9r ScoreExporter.parsePartlikeScoreLs2$$  * * ,,,G MMO-r;cURn[R"5nUHnURURU5 M! UR 5 [ X S9nUR 5 URRU5 g)a creates a single PartExporter for this Stream and parses it. Note that the Score does not need to be totally flat, it just cannot have Parts inside it; measures are fine. >>> c = converter.parse('tinyNotation: 3/4 c2. d e') >>> SX = musicxml.m21ToXml.ScoreExporter(c) >>> SX.parseFlatScore() >>> len(SX.partExporterList) 1 >>> SX.partExporterList[0] >>> SX.dump(SX.partExporterList[0].xmlRoot) ... >>> del SX.partExporterList[:] # for garbage collection rN) r"r^ coreInsertr coreElementsChangedr!rrr)ryrGrelr$s r9rScoreExporter.parseFlatScoreXsg* KK KKMB LLB '  ! )   $$R(r;cURH2nSnURHnURU;dMUn O X!lM4 g)zn Figures out the containing StaffGroup for every PartExporter that has one. Called automatically by .parse() N)rrr" staffGroup)rypartExp joinableGroupsgs r9r(ScoreExporter.setPartExporterStaffGroupsvsE ,,G M''>>R'$&M( "/ -r;c/nURGH=nURcMURU;aM%[R"URR 55nUR 5R [R5R5n[U5nUHnSnUHxnU[RH^n [U R[5(dM$U R[R:aU RS-nMSXyl US- nM` Mz M URUR5 GM@ g)z Renumbers voices (as appropriate) in each StaffGroup, so that voices have unique numbers across the entire group. Called automatically by .parse() Nr)rr/r"r\getSpannedElementsrrr`r#rbridintr#minIdNumberToConsiderMemoryLocationr) rystaffGroupsProcessedr0staffGroupScoremeasuresStreamoffsetIterator measureStack nextVoiceIdrrs r9r-ScoreExporter.renumberVoicesWithinStaffGroupss&(,,G!!)!!%99%ll7+=+=+P+P+RSO'')<LN=[N . #$ %Av||_)!$$44$TTH$P$PP*+$$(K$/D'1,K-&!/ ! ' '(:(: ;A-r;c UR5 UR5 [UR5HJupUR S[ US-5-5 UR RUR 5 ML g)z calls .joinPartStaffs() from the :class:`~music21.musicxml.partStaffExporter.PartStaffExporterMixin`, then calls .setScoreHeader(), then appends each PartExporter's xmlRoot from self.partExporterList to self.xmlRoot. Called automatically by .parse(). zPart rN)joinPartStaffssetScoreHeader enumeraterr%rRrr)ryrpexs r9rScoreExporter.postPartProcesssd   5 56FA  " "7SQZ#7 8 LL   ,7r;c6URn[U5UlUR5 UR 5 UR 5 UR H-nURRURU55 M/ UR5 g)a8 Sets the group score-header in . Note that score-header is not a separate tag, but just a way of grouping things from the tag. runs `setTitles()`, `setIdentification()`, `setDefaults()`, changes textBoxes to `` and does the major task of setting up the part-list with `setPartList()`. N) r"rJr setTitlessetIdentification setDefaultsrrrtextBoxToXmlCredit setPartList)ryrGtbs r9rBScoreExporter.setScoreHeadersw KK4A6    ..B LL   7 7 ; <! r;c^[S5nURb&URS[UR55 OURSS5 [S5nSUR;aURSS5 URUlUR X15 UR(akURn[R(a![U[R5(deURbURSUR5 URU5 U$) a Convert a music21 TextBox to a MusicXML Credit. >>> tb = text.TextBox('testing') >>> tb.style.absoluteY = 400 >>> tb.style.absoluteX = 300 >>> tb.page = 3 >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxCredit = SX.textBoxToXmlCredit(tb) >>> SX.dump(mxCredit) testing Default of page 1: >>> tb = text.TextBox('testing') >>> tb.page 1 >>> mxCredit = SX.textBoxToXmlCredit(tb) >>> SX.dump(mxCredit) ... * Changed in v8: Multi-line text now exports as one `` element (preserving newlines). >>> tb = text.TextBox('Snare\nCymbals') >>> mxCredit = SX.textBoxToXmlCredit(tb) >>> SX.dump(mxCredit) Snare Cymbals creditpage1z credit-words z xml:spacepreserverF)rrPr:rRcontentr&rOr4r$r r r TextStylerFr)rytextBoxmxCredit mxCreditWordsstys r9rJ ScoreExporter.textBoxToXmlCreditsL8$ << # LLW\\!2 3 LL %/ 7?? "   k: 6$__   7  & &--C!#u7777{{&!!)S[[9 &r;c8URc@[R"5n[RUl[R UlO URn[ URS5nURc UR bX[ US5n[ US5n[UR5Ul [ US5n[UR 5Ul URb,URUR5nURU5 URb,URUR5nURU5 URH%nUR!U5n URU 5 M' UR#U5 U$)av Returns a default object from self.firstScoreLayout or a very simple one if none exists. Simple: >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxDefaults = SX.setDefaults() >>> SX.dump(mxDefaults) 7 40 These numbers come from the `defaults` module: >>> defaults.scalingMillimeters 7 >>> defaults.scalingTenths 40 More complex: >>> s = corpus.parse('schoenberg/opus19', 2) >>> SX = musicxml.m21ToXml.ScoreExporter(s) >>> SX.setScoreLayouts() # necessary to call before .setDefaults() >>> mxDefaults = SX.setDefaults() >>> mxDefaults.tag 'defaults' >>> mxScaling = mxDefaults.find('scaling') >>> SX.dump(mxScaling) 6.1472 40 >>> mxPageLayout = mxDefaults.find('page-layout') >>> SX.dump(mxPageLayout) 1818 1405 83 83 103 103 >>> mxSystemLayout = mxDefaults.find('system-layout') >>> SX.dump(mxSystemLayout) 0 0 121 70 >>> mxStaffLayoutList = mxDefaults.findall('staff-layout') >>> len(mxStaffLayoutList) 1 >>> SX.dump(mxStaffLayoutList[0]) 98 rscaling millimeterstenths)rrrrscalingMillimeters scalingTenthsrrrRr&rrrrrstaffLayoutListraddStyleToXmlDefaults) ry scoreLayout mxDefaults mxScaling mxMillimetersmxTenthsrrrrs r9rIScoreExporter.setDefaultssZR  ( ,,.K-5-H-HK *(0(>(>K %//K j9  ) ) 59R9R9^":y9I&y-@M!$[%C%C!DM !)X6H 9 9:HM  ! ! -99+:P:PQL   l +  # # /!?? @X@XYN   n -&66K <<[IM   m ,7 "":.r;cURR(dgUR5nUbURU5 URRnUR b'[ US5nURXCR 5 URb'[ US5nURXSR5 URH<upg[ US5nUbURX5 UcM*URSU5 M> URH=up[ US5n U bU RSU 5 U cM+U RSU 5 M? g)a" Optionally add an tag (using `styleToXmlAppearance`) and , , zero or more tags, and zero or more tags to mxDefaults Demonstrating round tripping: >>> import xml.etree.ElementTree as ET >>> defaults = ET.fromstring('' ... + '' ... + '' ... + '' ... + '' ... + '' ... + '' ... + '') >>> MI = musicxml.xmlToM21.MusicXMLImporter() >>> MI.styleFromXmlDefaults(defaults) >>> SX = musicxml.m21ToXml.ScoreExporter(MI.stream) >>> mxDefaults = ET.Element('defaults') >>> SX.addStyleToXmlDefaults(mxDefaults) >>> SX.dump(mxDefaults) Nz music-fontz word-fontz lyric-fontrzlyric-languagezxml:lang) r"r4styleToXmlAppearancerr$ musicFontrr]wordFont lyricFontsr:lyricLanguages) ryrd mxAppearancer mxMusicFont mxWordFont lyricName lyricFont mxLyricFont lyricType lyricLangmxLyricLanguages r9rb#ScoreExporter.addStyleToXmlDefaults~s#D{{.. 002  #   l + [[   << #$Z>K LLll 3 ;; "#J K$ [4$ 2 %2%'$5$5 I(5EFO$##FI6$##J : %6r;cnURRnUR(d4UR(d#UR(dUR (dg[ S5nSHHup4[X5nUH2upg[X$5nURSU5 [U5Ul M4 MJ U$)a Populates the tag of the with information from the stream's .style information. >>> s = stream.Score() >>> s.style.lineWidths.append(('beam', 5.0)) >>> s.style.noteSizes.append(('cue', 75)) >>> s.style.distances.append(('hyphen', 0.1)) >>> s.style.otherAppearances.append(('flags', 'wavy')) >>> SX = musicxml.m21ToXml.ScoreExporter(s) >>> mxAppearance = SX.styleToXmlAppearance() >>> SX.dump(mxAppearance) 5.0 75 0.1 wavy N appearance)) lineWidthsz line-width) noteSizesz note-size) distancesr)otherAppearanceszother-appearancetype) r"r$r{r|r}r~rrPrr:rRr&) ryrro thisPropertyrU propertyList propertyType propertyValue mxPropertys r9rj"ScoreExporter.styleToXmlAppearances*[[     ++|, "L L#24L/;+ ' : v|4"%m"4 0< "Lr;cFURn[URS5nUR[R 5n0nSnUR GHJnURnUHrnXR;aMURU5(dM,URU5n U RS[U55 XU'US- nURU 5 Mt UR5n URU 5 Sn UHnXR;aMURU5(dM,UR!5H upXLdM U n O [#S5n U RSS5 U bU RS[U 55 URU 5 M GMM U$)a Returns a and appends it to self.xmlRoot. This is harder than it looks because MusicXML and music21's idea of where to store staff-groups are quite different. We find each stream in self.partExporterList, then look at the StaffGroup spanners in self.spannerBundle. If the part is the first element in a StaffGroup then we add a object with 'start' as the starting point (and same for multiple StaffGroups) this is in `staffGroupToXmlPartGroup(sg)`. then we add the descriptor of the part and its instruments, etc. (currently just one!), then we iterate again through all StaffGroups and if this part is the last element in a StaffGroup we add a descriptor with type="stop". This Bach example has four parts and one staff-group bracket linking them: >>> b = corpus.parse('bwv66.6') >>> SX = musicxml.m21ToXml.ScoreExporter(b) Needs some strange setup to make this work in a demo. `.parse()` takes care of all this. >>> SX.scorePreliminaries() >>> SX.parsePartlikeScore() >>> mxPartList = SX.setPartList() >>> SX.dump(mxPartList) ... ... ... ... ... Multi-staff parts (such as piano staves), should NOT receive `` tags, since they are joined by `` tags: >>> cpe = corpus.parse('cpebach') >>> SX = musicxml.m21ToXml.ScoreExporter(cpe) >>> SX.scorePreliminaries() >>> SX.parsePartlikeScore() >>> SX.joinPartStaffs() >>> mxPartList = SX.setPartList() >>> SX.dump(mxPartList) ... z part-listrrN part-grouprstop)rrr getByClassr StaffGrouprr"risFirststaffGroupToXmlPartGroupr:rRrgetXmlScorePartisLastrr)ryr mxPartList staffGroupspartGroupIndexRefpartGroupIndexrDrr2 mxPartGroup mxScorePart activeIndexkr8s r9rKScoreExporter.setPartLists|l**  k: $..v/@/@A ((C A!***::a=="&"?"?"CKOOHc..AB8:n5"a'N%%k2"--/K   k *K!***99Q<<$5$;$;$= ;*+K!%>#*,"7KOOFF3".##k2BC%%k2"%)Dr;c[S5nURSS5 [nU"XSS5 URR(a[ US5nURSS5 U"XS S 5 U"XS S 5nUb"UR XQ5 URXQ5 [ US 5nURSLaSUl O.URSLaSUl OURS:XaSUl URX!5 U$)aT Create and configure an mxPartGroup object for the 'start' tag from a staff group spanner. Note that this object is not completely formed by this procedure (number isn't done). >>> b = corpus.parse('bwv66.6') >>> SX = musicxml.m21ToXml.ScoreExporter(b) >>> firstStaffGroup = b.spannerBundle.getByClass(layout.StaffGroup)[0] >>> mxPartGroup = SX.staffGroupToXmlPartGroup(firstStaffGroup) >>> SX.dump(mxPartGroup) bracket yes At this point, you should set the number of the mxPartGroup, since it is required: >>> mxPartGroup.set('number', str(1)) What can we do with it? >>> firstStaffGroup.name = 'Voices' >>> firstStaffGroup.abbreviation = 'Ch.' >>> firstStaffGroup.symbol = 'brace' # 'none', 'brace', 'line', 'bracket', 'square' >>> firstStaffGroup.barTogether = False # True, False, or 'Mensurstrich' >>> mxPartGroup = SX.staffGroupToXmlPartGroup(firstStaffGroup) >>> SX.dump(mxPartGroup) Voices Ch. brace no Now we avoid printing the name of the group: >>> firstStaffGroup.style.hideObjectOnPrint = True >>> mxPartGroup = SX.staffGroupToXmlPartGroup(firstStaffGroup) >>> SX.dump(mxPartGroup) Voices Ch. brace no rrstartz group-namerzgroup-name-displayrarbzgroup-abbreviation abbreviationz group-symbolsymbolz group-barlineTrF Mensurstrich) rr:rXr$rcrr^r\ barTogetherr&r)ryr/rrmxGroupNameDisplay mxGroupSymbolmxGroupBarlines r9r&ScoreExporter.staffGroupToXmlPartGroupMsdl+ (' ZlF;    - -!+K9M!N   " ">4 8 Z&:NKZnhO  $ MM- 4   ] 7#KA  ! !T )"'N   # #u ,"&N   # #~ 5"0N  +2r;cURb URnO[URS5nXlSnURbHURR SSSS9H)up4UR U5nUR U5 SnM+ USLaH[R(a3[US5nURSS5 [RUl URb]URSnUHHn[US 5nURbURSUR5 [U5Ul MJ UR5 UR5 U$) a Returns an identification object from self.scoreMetadata and appends it to the score. For defaults: >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxIdentification = SX.setIdentification() >>> SX.dump(mxIdentification) Music21 20...-...-... music21 v... More realistic: >>> md = metadata.Metadata() >>> md.composer = 'Francesca Caccini' >>> c = metadata.Contributor(role='arranger', name='Aliyah Shanti') >>> md.addContributor(c) Need a fresh ScoreExporter, or, it will otherwise append to the existing mxIdentification >>> SX = musicxml.m21ToXml.ScoreExporter() >>> SX.scoreMetadata = md >>> mxIdentification = SX.setIdentification() >>> SX.dump(mxIdentification) Francesca Caccini Aliyah Shanti ... music21 v... Overriding the default: >>> defaults.author = "Batch Conversion March 2022" >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxIdentification = SX.setIdentification() >>> SX.dump(mxIdentification) Batch Conversion March 2022 20...-...-... music21 v... identificationFT)skipNonContributorsreturnPrimitives returnSortedcreatorrcomposer copyrightrights)rrrrallcontributorToXmlCreatorrrauthorr:r&rolerR setEncodingmetadataToMiscellaneous)rymxIdfoundOne_r mxCreator copyrightsmxRightss r9rHScoreExporter.setIdentificationsEp  ,((Ddll,<=D$( !    ) **..(,%)!&/(!88;  I& ( u "43I MM&* -%__IN    )9=9K9KK9XJ%dH566%LL0 #A    $$& r;cxUcURcgUc URn[R(aUce[S5nSnUR SSSS9nSnSnSnUHupUS:XaM US:Xa U(dSnMUS:Xa U(dSnM/US :Xa U(dSnM@US :XaMHUR U5n U cUn U R S 5(aMv[US 5n U RS U 5 [U 5U l SnM URb"U(aURRU5 U$)a Returns an mxMiscellaneous of information from metadata object md or from self.scoreMetadata if md is None. If the mxMiscellaneous object has any miscellaneous-fields, then it is appended to self.mxIdentification if it exists. >>> SX = musicxml.m21ToXml.ScoreExporter() >>> md = metadata.Metadata() >>> md.date = metadata.primitives.DateRelative('1689', 'onOrBefore') >>> md.localeOfComposition = 'Rome' >>> mxMisc = SX.metadataToMiscellaneous(md) >>> SX.dump(mxMisc) 1689/--/-- or earlier Rome N miscellaneousFT)skipContributorsrrsoftware movementNamemovementNumberrrz m21FileInfo:zmiscellaneous-fieldr) rr r rruniqueNameToNamespaceName startswithrr:rRr&rr) ryrHmxMiscellaneousrallItemsskippedOneMovementNameskippedOneMovementNumberskippedOneTitle uniqueNamer8 namespaceName mxMiscFields r9r%ScoreExporter.metadataToMiscellaneoussf. :$,,4 Z##B ??> !>!/266!!  (-). %!) JZ'^+.-1*--0/3,W$'&*O[(&(&B&B:&NM$ * ''77$_6KLK OOFM 2"5zK HW"*Z  ,  ! ! ( ( 9r;c URb[URS5nO [S5n[US5n[[R R 55UlURbCSnURRH&nSU;a U(aMSn[US5nXElM( O![US5n[RUlUR5nUHnURU5 M U$)a Returns an encoding object that might have information about also. and appends to mxIdentification (if any) Will use the date of generation as encoding-date. >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxEncoding = SX.setEncoding() >>> SX.dump(mxEncoding) 20...-...-... music21 v... Encoding-date is in YYYY-MM-DD format. encodingz encoding-dateFz music21 v.Tr) rrrrRdatetimedatetodayr&rrr getSupportsr)ry mxEncodingmxEncodingDatefound_m21_alreadyr mxSoftwaremxSupportsList mxSupportss r9rScoreExporter.setEncodingZ s$  ,#D$9$9:FJ ,J#J@!(--"5"5"78    ) %  ..778+(!,0)' J? "*8$J ;J&//JO))+(J   j ))r;cSn/nURnURSLaURU"SSSS55 URSLaURU"SSSS55 U$)ax return a list of tags for what this supports. Does not append Currently just supports new-system and new-page if s.definesExplicitSystemBreaks and s.definesExplicitPageBreaks is True. >>> SX = musicxml.m21ToXml.ScoreExporter() >>> SX.getSupports() [] >>> SX.stream.definesExplicitSystemBreaks = True >>> SX.getSupports() [] >>> SX.dump(SX.getSupports()[0]) >>> SX.stream.definesExplicitPageBreaks = True >>> SX.dump(SX.getSupports()[1]) c[S5nURSU5 URSU5 URSU5 URSU5 U$)Nsupports attributerr8element)rr:)r supports_typer8rsus r9 getSupport-ScoreExporter.getSupports..getSupport sI$B FF; * FF6= ) FF7E " FF9g &Ir;Trrrr)r"definesExplicitSystemBreaksrdefinesExplicitPageBreaks)ryr supportsListrGs r9rScoreExporter.getSupports sk*  KK ( (D 0    <w O P & &$ .    :ueW M Nr;cURnURc[R"5n[R(aUceUR n[ S5nSnUSnU(a'UcUSn[US5n[US5Ul [U5(aURU5 USnU(a[US5n[US5Ul Sn US n U (a[U S5n O6Ub [U5n O'[R(a[Rn Og[US 5n Xl g) zT puts work (with work-title), movement-number, movement-title into the self.xmlRoot Nworkrrz work-titlerzmovement-numberr=rzmovement-title)rrrr r rrrrRr&rrrr) rymdObj mxScoreHeadermxWorkfirstTitleFoundtitles mxWorkTitlemovementNumbersmxMovementNumbermovement_title movementNamesmxMovementTitles r9rGScoreExporter.setTitles s)""    %%%'E ??$ $$ .2,1'N &"()$V\:K"6!9~K  v;;   (5:;K5L )-9JK $'(:$;  !!383H  q!12N*!$_!5!)$]4DE-r;c[S5nURb%URS[UR55 URbURUlU$)a Return a tag from a :class:`~music21.metadata.Contributor` object. >>> md = metadata.Metadata() >>> md.composer = 'Oliveros, Pauline' >>> contrib = md.contributors[0] >>> contrib >>> SX = musicxml.m21ToXml.ScoreExporter() >>> mxCreator = SX.contributorToXmlCreator(contrib) >>> SX.dump(mxCreator) Oliveros, Pauline rr)rrr:rRrr&)ryrrs r9r%ScoreExporter.contributorToXmlCreator sI I& 66  MM&#aff+ . 66 VVINr;)rrrrrrrxrrrrrrrrrr"rrru)rzstream.Score | Nonerxboolrrr)rVz text.TextBoxrrr)rHmetadata.Metadata | NonerElement | None)!rrrrrr{rrrrrrrrrrrrrBrJrIrbrjrKrrHrrrrGrr __classcell__rs@r9rrTs "/"/H)V!F;2.#`',/& - )< /(@eN>;@(TcJJX`H&*] "] ]~2h%N..`r;rc^\rSrSr%SrSS0rS\S'SSU4SjjjrSrS r SS jr S r S r S r SrSrSrU=r$)r!i z? Object to convert one Part stream to a tag on .parse() previousPartStaffInGroupa= If the part being exported is a :class:`~music21.stream.base.PartStaff`, this attribute will be used to store the immediately previous `PartStaff` in the :class:`~music21.layout.StaffGroup`, if any. (E.g. if this is the left hand, store a reference to the right hand.)zdict[str, str] _DOC_ATTRc(>[TU]5 Uc[R"5nXlX l[ S5UlUc2[R"5UlSS/Ul /Ul SUl OfURb URO[R"5UlURUl URUl URUl SUl SUl SUlSUlSUlUR"Ulg)NpartrT)rr{r"r^r rrrdrrrrxrinstrumentStreamfirstInstrumentObject lastDivisionsr/r)rypartObjr rs r9r{PartExporter.__init__ s  ?kkmG07  v >GM}}D ),c D %#%D $D $*#5#5#A!' 2 2%+]]_  )/(C(CD %#)#9#9D & 3 3D ?C%KO%)""37$22r;cURRSSS9 UR(aqURRSS9SUlURR [R 5(aUR 5 OJUR5 O9URR [R 5(d [S5eURR5 UR5 URRS[URR 55 URR [R 5HpnUR#S[UR$5-5 ['XS9nURUl UR)5nURR3U5 Mr UR$![aen[UR$5Ul[-UR[R.5(aURR0UlUeS nAff=f) af Set up instruments, convert sounding pitch to written pitch, create a partId (if no good one exists) and set it on , fixes up the notation (:meth:`fixupNotationFlat` or :meth:`fixupNotationMeasured`), setIdLocals() on spanner bundle. Run parse() on each measure's MeasureExporter and append the output to the object. In other words, one-stop shopping. :attr:`makeNotation` when False, will avoid running :meth:`~music21.stream.base.Stream.makeNotation` on the Part. Generally this attribute is set on `GeneralObjectExporter` or `ScoreExporter` and read from there. Running with `makeNotation` as False will raise `MusicXMLExportException` if no measures are present. If `makeNotation` is False, the transposition to written pitch is still performed and thus will be done in place. >>> from music21.musicxml.m21ToXml import PartExporter >>> noMeasures = stream.Part(note.Note()) >>> pex = PartExporter(noMeasures) >>> pex.makeNotation = False >>> pex.parse() Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Cannot export with makeNotation=False if there are no measures Trrrz>Cannot export with makeNotation=False if there are no measuresr6zMeasure rN)r"rrxsplitAtDurationsrr`fixupNotationMeasuredfixupNotationFlatr,r setIdLocalsinstrumentSetuprr:rRrpartIdr%rMeasureExporterr measureNumberrr^rr)ryrmeasureExporter mxMeasurers r9rPartExporter.parse2 s@ ""44"H   ++66t6DQGDK{{--fnn==**,&&(//??)PR R &&(  s4#=#=#D#DEF//?A  " ":AHH #= >-a=O,0,>,>O ) +113  LL   *@||+ "%ahh-dkk6;;77!%!5!5AJ  s'G"" I,A I  IcURb_[UR5URR;a2URR[UR5UlOURR SSS9UlURSUlURb0URRVs/sHoRPM nnOURR/nUR RnX2;dUcUR R5 UR5nU(ag[5nURGH[n[U5U;aMUR[U55 URbURUR;aUR!URS9 URR-UR5 UR.b5UR(a4UR.URR0;aUR35 URcMURR0R-UR.5 X`R LdGM6URRR-U5 GM^ gs snf!["R$a)n[&R)[+U55 SnAGN.SnAff=f)a Sets self.instrumentStream and self.firstInstrumentObject for the stream, checks for a unique midiChannel and then blocks it off from future use. >>> p = converter.parse('tinyNotation: 4/4 c1 d1 e1') >>> p.getElementsByClass(stream.Measure)[0].insert(0, instrument.Clarinet()) >>> p.getElementsByClass(stream.Measure)[1].insert(0, instrument.BassClarinet()) >>> PEX = musicxml.m21ToXml.PartExporter(p) >>> PEX.instrumentStream is None True >>> PEX.firstInstrumentObject is None True >>> PEX.instrumentSetup() >>> PEX.instrumentStream The "P" signifies that it is the main instrument associated with a Part. >>> PEX.instrumentStream.show('text') {0.0} {4.0} NTrrr) usedChannels)r r6r"rrgetInstrumentsrrr partIdRandomize#mergeInstrumentStreamPartStaffAwarer:radd midiChannelrautoAssignMidiChannelrInstrumentException environLocalrrRr instrumentIdrinstrumentIdRandomize)ryr0 instIdList firstInstIdshould_short_circuitseen_instrument_classesthisInstrumentrs r9rPartExporter.instrumentSetupx sK0 ;; "r$++$++:Y:Y'Y%)KK$C$CBt{{O$TD !%)KK$>$>T[_$>$`D !%)%:%:1%=" ;; ",0KK,F,FG,Fq((,FJGJ++..)J0077  $ (;  & & 6 6 8#GGI  "%%"33NN#'>> # ' '^(< =**2%11T5I5II."88dFZFZ8[  ' '(B(B C++3KK&33t{{7S7SS446{{& ,,33N4O4OP!%?%??KK..55nE;4H0$77. %%c!f--.sJ;1KK=K88K=cTURcgURR(dgURRHnURUR5(aUSSHnUR SSS9nU=R U- slUR b[ R"UR SS9 UR(dMgUR cMv[U5nUR URRU'M MURU;dM g g)a! Merges instrument streams from subsequent parts in a PartStaff group. Does nothing in the normal case of single staves. Returns whether instrument processing should short circuit, which is False for the general case and True for subsequent PartStaff objects after the first in a group. NFrTrr) r rrr"rrr deduplicater6r)ry joined_groupsubsequent_staffother_instrumentsnext_ids r9r0PartExporter.mergeInstrumentStreamPartStaffAware s ;; {{'' KK44L##DKK00(4QR(8$(8(G(G&*D)H):%))->>),,8"..t/D/DdS{{{t'<'<'H"$%5"6CGCXCX 77@)9 , '5(r;cURnUR5 URURURSS9 UR Ulg)zB Runs makeNotation on a flatStream, such as one lacking measures. T)rrrN)r" makeMutablerxrrr)ryrs r9rPartExporter.fixupNotationFlat sR{{  d&6&6/3/H/H"&  (&"//r;c2URnUR[R5nUR5nU(dg[ US5(aXUR cKUR 5 UR[ R5nU(aUR5Ul[ US5(aXURcKUR 5 UR[R5nU(aUR5Ul[ US5(aXURcKUR 5 UR[R5nU(aUR5Ul URR5(dUR!SS9 URR"(dUR%SS9 URR2(d=UH7nU/UR4QH!n [R6R9U SS9 M# M9 UR:(dUR:Ulgg![&R(a.n[*R,"[.[1U55 SnANSnAff=f)a Checks to see if there are any attributes in the part stream and moves them into the first measure if necessary. Checks if makeAccidentals is run, and haveBeamsBeenMade is done, and tuplets have been made. * Changed in v7: no longer accepts `measureStream` argument. Nr keySignaturerTr)r"rr`rrtr r*rr-r KeySignaturerr TimeSignature streamStatushaveAccidentalsBeenMademakeAccidentalsbeams makeBeamsrStreamExceptionrrr-rRtupletsvoicesrxrr) ryrmeasures first_measure outerClefsouterKeySignaturesouterTimeSignaturesserm_or_vs r9r"PartExporter.fixupNotationMeasured s{{**6>>: (   =& ) )m.@.@.H  % % '00;J%/%5%5%7 " =. 1 1m6P6P6X  % % '!%!8!89I9I!J !-?-E-E-G * =/ 2 2}7R7R7Z  % % '"&"9"9%:M:M"N ".A.G.G.I +  88::   .  && 8t,   (( n188nF''::64:P-!!!%!3!3D " // 8 os2w77 8s IJ($JJcURn[S5nURSURR S55 [ US5n[ US5(aURbURUlO[RUlUR(a-URR(dURSS5 [ URS5(ahURb[[ US5nURUlUR(a-URR(dURSS5 [5nURHwn[!U5U;aMUR"cUR$cUR&cM=UR)UR+U55 UR-[!U55 My [5nURH|n[!U5U;aMUR&c![/U[0R25(dMBUR)UR5U55 UR-[!U55 M~ U$) z make a from a music21 Part object and a parsed mxPart () element. contains details about instruments, etc. called directly by the ScoreExporter as a late part of the processing. z score-partr6z part-namerrarbrzpart-abbreviation)r"rr:rgetrrtrr&rr4r$ printPartNamerprintPartAbbreviationrrinstrumentNameinstrumentAbbreviation midiProgramrinstrumentToXmlScoreInstrumentrrrUnpitchedPercussioninstrumentToXmlMidiInstrument)ryrr mxPartNamemxPartAbbreviationrinsts r9rPartExporter.getXmlScorePart@ s{{l+ dll..t45 [9 4 $ $)B"mmJO&//JO  # #DJJ,D,D NN>4 0 4;; 2 3 38M8M8Y!+K9L!M &*&;&;  #'' 0P0P"&&~t< #&%))DDz44##/22>''3""4#F#Ft#LM'++DJ7*#&%))DDz44+z$ @^@^/_/_""4#E#Ed#KL'++DJ7*r;c[S5nURS[UR55 [ US5n[UR 5UlURb&[ US5n[UR5UlU$)a4 Convert an :class:`~music21.instrument.Instrument` object to a element and return it. >>> i = instrument.Clarinet() >>> i.instrumentId = 'clarinet1' >>> i.midiChannel = 4 >>> PEX = musicxml.m21ToXml.PartExporter() >>> mxScoreInstrument = PEX.instrumentToXmlScoreInstrument(i) >>> PEX.dump(mxScoreInstrument) Clarinet Cl >>> i.instrumentName = "Klarinette 1." >>> i.instrumentAbbreviation = 'Kl.1' >>> mxScoreInstrument = PEX.instrumentToXmlScoreInstrument(i) >>> PEX.dump(mxScoreInstrument) Klarinette 1. Kl.1 zscore-instrumentr6zinstrument-namezinstrument-abbreviation)rr:rRrrrDr&rE)ryrmxScoreInstrumentmxInstrumentNamemxInstrumentAbbreviations r9rG+PartExporter.instrumentToXmlScoreInstrument| s4$$67dC$78%&79JK #A$4$4 5 # # /'12CE^'_ $,/0H0H,I $ ) ! r;cb[S5nURS[UR55 URcUR UR 5 [US5n[URS-5Ul URb)[US5n[URS-5Ul [U[R5(a6URb)[US5n[URS-5Ul U$![Ra SUlNf=f)a6 Convert an instrument object to a tag and return the element >>> i = instrument.Clarinet() >>> i.instrumentId = 'clarinet1' >>> i.midiChannel = 4 >>> PEX = musicxml.m21ToXml.PartExporter() >>> mxMidiInstrument = PEX.instrumentToXmlMidiInstrument(i) >>> PEX.dump(mxMidiInstrument) 5 72 >>> m = instrument.Maracas() >>> m.instrumentId = 'my maracas' >>> m.midiChannel # 0-indexed 9 >>> m.percMapPitch 70 >>> PEX = musicxml.m21ToXml.PartExporter() >>> mxMidiInstrument = PEX.instrumentToXmlMidiInstrument(m) >>> PEX.dump(mxMidiInstrument) # 1-indexed in MusicXML 10 71 zmidi-instrumentr6rz midi-channelrz midi-programzmidi-unpitched)rr:rRrrrrrrrr&rFrrrH percMapPitch)ryrmxMidiInstrument mxMidiChannel mxMidiProgrammxMidiUnpitcheds r9rI*PartExporter.instrumentToXmlMidiInstrument s<##45T3q~~#67 ==  "''(<(<=##3^D  !23  == $&'7HM!$Q]]Q%6!7M  a77 8 8Q^^=W()9;KLO#&q~~'9#:O  ! 33 " !  "sDD.-D.) rrrrxrrr rrrr/r"rNN)rz!stream.Part | stream.Score | Noner zScoreExporter | Nonerr)rrrrrr__annotations__r{rrrrrrrGrIrrrs@r9r!r! sz #%D!I~;?.2%37%3+%3%3NDLLF\%N0:44l:x%!N3 3 r;r!cR^\rSrSr\"/SQ5r\"/SQ5rSS1rSWSXU4SjjjrSr Sr SYS jr SYS jr S S .SZS jjr \R4S[SjjrS\SjrS]Sjr\S^Sj5r\S^Sj5rS_SjrS`SaSjjrSbSjrScSjrS`SdSjjrSeSjrSfSjrSgSjrShSjrSiSjrS`SjSjjr SkSjr!SlSjr"SmS jr#SkS!jr$SbSnS"jjr%SoS#jr&S$r'SpS%jr(S`SqS&jjr)SrS'jr*SrS(jr+SsS)jr,StS*jr-SuS+jr.S,r/SvS-jr0\SwS.j5r1\SxS/j5r2SyS0jr3SzS1jr4S2S3.S{S4jjr5SbS2S5.S|S6jjjr6SbS2S5.S}S7jjjr7S~S8jr8SS9jr9SS:jr:SS;jr;SS<jrjr>SS?jr?SS@jr@SSSAjjrASSBjrBSCrCSDrDSErESFrFSGrGSHrHSIrISJrJSKrKSLrLSSMjrMSNrNSOrOSbSPjrPSQrQSbSRjrRSSrSSTrTSUrUSVrVU=rW$)r i ))r noteToXml)NoChord noChordToXml)ChordWithFretBoardchordWithFretBoardToXml) ChordSymbolchordSymbolToXml) RomanNumeralromanNumeralToXml) ChordBase chordToXml) UnpitchedunpitchedToXml)r restToXml)rl dynamicToXml)Segno segnoToXml)Coda codaToXml) TempoTexttempoIndicationToXml) MetronomeMarkrr)MetricModulationrr)TextExpressiontextExpressionToXml)RepeatExpressionrv) RehearsalMarkrehearsalMarkToXml) PedalObjectpedalObjectToXml))r clefToXml)r.keySignatureToXml)r/timeSignatureToXml LayoutBaseBarlinec>[TU]5 Uc[R"5UlOXlX l[ S5Ul[RUl [UR UR5 SUl SUl SUl SUlSUlSUlSUl0Ul/UlUc[(R*"5UlOUR,UlUR,Ulg)Nrrr)rr{r"r`r rrrdivisionsPerQuartercurrentDivisionssynchronizeIdstranspositionInterval mxTransposemeasureOffsetStartoffsetInMeasurecurrentVoiceIdnextFreeVoiceNumbernextArpeggioNumberarpeggioNumbers rbSpannersr! SpannerBundlerobjectSpannerBundle)ry measureObjr rs r9r{MeasureExporter.__init__ s    ..*DK$K y) ( < < t||T[[1&*""%",0() '(KM79 >!(!6!6!8D !'!5!5D #'#5#5 r;cUR5 UR5 UR5 UR5 UR 5 UR 5 UR 5 UR5 UR$)z main parse call. deals with transposing, repeat brackets, setting measureNumber and width, the first mxPrint, the first tag, the left barline, parsing all internal elements, setting the right barline, then returns the root tag. ) setTranspose setRbSpannerssetMxAttributes setMxPrint&setMxAttributesObjectForStartOfMeasuresetLeftBarlinemainElementsParsesetRightBarlinerrs r9rMeasureExporter.parse sl     335    ||r;cURnUR5(dURUSS9 gUR[R5R5nURUSS9 [ UR 5n[U5H+upEU[U5S- :XaSnOSnURXVS9 M- g)zP deals with parsing all the elements in a stream, whether it has voices or not. FbackupAfterwardsNTr) r" hasVoicesparseFlatElementsgetElementsNotOfClassrbrr7rCr)ryrnonVoiceMeasureItems allVoicesrrrs r9r!MeasureExporter.mainElementsParse2 s KK{{}}  " "1u " =  66v||DKKM 3dKN i(DAC NQ&&#( #'   " "1 " H)r;c[[XR-55nU(aX[S5n[ US5n[ U5UlURRU5 U=RU- sl gg)ab Moves self.offsetInMeasure forward by an OffsetQL, appending the appropriate tag (expressed in divisions) to self.xmlRoot. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> len(MEX.xmlRoot) 0 >>> MEX.moveForward(1) >>> MEX.dump(MEX.xmlRoot) 10080 >>> len(MEX.xmlRoot) 1 forwardrN r7roundrrrrRr&rrr)rybyOffsetamountToMoveForward mxForward mxDurations r9 moveForwardMeasureExporter.moveForwardK sk&$'uX8M8M-M'N#O  *I#Iz:J!"56JO LL   *  H , r;c[[XR-55nU(aX[S5n[ US5n[ U5UlURRU5 U=RU-sl gg)a` Moves self.offsetInMeasure backward by an OffsetQL, appending the appropriate tag (expressed in divisions) to self.xmlRoot. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> len(MEX.xmlRoot) 0 >>> MEX.moveBackward(2) >>> MEX.dump(MEX.xmlRoot) 20160 >>> len(MEX.xmlRoot) 1 backuprNr)ryramountToBackupmxBackuprs r9 moveBackwardMeasureExporter.moveBackwardf si$"%3H3H(H"IJ x(H#Hj9J!.1JO LL   )  H , r;FrcB^STl[U[R5(a[UR[ 5(a5UR[ R:aURnUS-TlOP[UR[ 5(a"TRnT=RS- slOURnOSnUTl [UR[R55n[U5nUGHnURUS5nUTR- nUS:a([!SU55(aTR#U5 /n UHn [U [R5(aM$[U [$R&5(aL[U [(R*5=n (aU (a$U R,(aU R/U 5 MU(a"TR1U [2R45 MTR1U [2R65 M U Hn U R8(a7U R:R<(aU R>R@S:XaMKU(a"TR1U [2R45 MtTR1U [2R65 M GM TRn U(aTR(aTRCTR5 [U5nUHn[!U4SjU55(dMURUS5nUTR- nUS:aTR#U5 UH#n TR1U [2RD5 M% M U(a-TR(aTRCTR5 O7TRU :a'TR#[GU TR- 55 STl g)a Deals with parsing all the elements in .elements, assuming that .elements is flat. `m` here can be a Measure or Voice, but it must be flat. If m is a 'Voice' class, we use the .id element to set self.currentVoiceId and then send a backup tag to go back to the beginning of the measure. Note that if the .id is high enough to be an id(x) memory location, then a small voice number is used instead. rrNrc3v# UH/n[U[R[R45v M1 g7fr)rrrfr r)r/rzs r9r14MeasureExporter.parseFlatElements.. s-/XNVsJsT%5%5tyy$ABBhs79r5c3F># UHnTRU5v M g7fr)_hasRelatedSpanners)r/rzrys r9r1r sMHS433C88Hs!)$rrr"rbr6r7rr8rrrrr! SpannerAnchorr# elementOffsetanyrrrfrHarmony writeAsChordrparseOneElementrNONENORMALisRestr$rcrrr RELATED_ONLYr)ryrrvoiceIdhasSpannerAnchors objIteratorobjGroup groupOffsetoffsetToMoveForward notesForLaterrzisHarmrfirstPassEndOffsetInMeasures` r9r!MeasureExporter.parseFlatElements s5" # a & &!$$$$0\0\)\$$+2Q;(ADD#&&22((A-($$G%#'q';';G`$((N,?,?@((N,A,AB#?$`150D0D# ##!!$"6"67(+K'MHMMMoohqk: &1D4H4H&H#&*$$%89$C((n.I.IJ$( ##!!$"6"67##&AA  (CdFZFZ(Z![\"r;cURnURRU5UlUR U5upEU[ R :waUHnURU5 M U[ R:wGaURnSU;a;[USS5(a)U=RURR- sl URRS:Xa6URRURl UR5nOP[!URR"5S:a*URR%SS9 UR5nOU/nSn UR&R)5H*upX;dM [X 5n UH n U "U 5 M Sn O UR*R)5H3upX;dM [X 5n UHn UR-X5 M Sn O U SLa8UHn XR.;dMSn O U SLa[0R3SU/5 O^U(aWURS :aGSUR;a7[USS5(a%UR5URR5 U[ R :waUHnURU5 M g g ) zT parse one element completely and add it to xmlRoot, updating offsetInMeasure, etc. rfrTr5rrFzdid not convert objectrN)rrgetBySpannedElementrrelatedSpannersrrrrrrPrrrrrr dotGroupssplitDotGroupsclassesToMethodsrwrapAttributeMethodClasseswrapObjectInAttributesignoreOnParseClassesr printDebugr)ryrzappendSpannersrootpreListpostListr#robjList parsedObject classNamerros r9rMeasureExporter.parseOneElement su||#'#5#5#I#I##N  005 ^00 0 B ^88 8kkG'GC,N,N$$ (B(BB$||  O3-0\\-G-G *..0S\\++,q0 ++D+9..0% L'+'<'<'B'B'D# '"42D$Q%#'L (E(,'F'F'L'L'N# '"42D$33A<%#'L (Ou$!(I $=$=='+ ") 5( ++-Es,KLC--1!CKK/GCQU4V4V$$S\\%?%?@ ^00 0 B 1r;cNURRU5nU(dgUR[R[ R [R[R45H1nURU5(dURU5(dM1 g g)z returns True if and only if: (1) there are spanners related to the object that should appear before the object to the tag, or (2) there are spanners related to the object that should appear after the object in the measure tag. FT) rrrr!Ottavar DynamicWedgeLiner PedalMarkrr)ryrzr thisSpanners r9r#MeasureExporter._hasRelatedSpannersR s**>>sC )33W^^5=5J5J5<\\5@5J5J5LMK""3'';+=+=c+B+B Mr;c *SnURnU(dg/n/nSSSSS.nUR5GHZupxUupURU5GH:n U"X5GH)n [U 5n [ X5 U R S[ U R55 US :Xa%U R S [ U R55 U S :XaURX{5nOU S :XaURX{5nO0nS U;aU R S [ US 55 U H.nX;dM XcMU R U[ X55 M0 [S5n[ UU 5 [U S5(a2U Rb%UR S[ U R55 [US5nURU 5 U S :XaURU5 OURU5 US:XdGMU S :XdGM[R (a![#U [$R&5(deU R([$R*R,:XdGMUR/U 5nURU5 GM, GM= GM] XE4$)z return two lists or empty tuples: (1) spanners related to the object that should appear before the object in the tag. (2) spanners related to the object that should appear after the object in the tag. c[U5S:XaSnU$URU5(aURU5(aSnU$URU5(aSnU$URU5(aSnU$SnU$)Nr)rlast)r)rr)rrr)r innerTargetprocs r9getProc0MeasureExporter.relatedSpanners..getProcq s2w!|(K::k**ryy/E/E,DK ZZ ,,%D K YY{++$DKDKr;)rr)z octave-shift)size)wedge)spread)r)line-end end-length)pedal)linesign abbreviated)rrrrrr line-typerrrr placementdirection-typer)rrrrrr:rRidLocallineType_spannerStartParameters_spannerEndParametersrtrrrr r rrr pedalForm PedalForm SymbolLinemakePedalResumeLineXml)rytargetrrrr paramsSetm21spannerClass infoTuplemxTag parameterSetrposSub mxElement spannerParamsattrName mxDirectionmxDirectionType mxPedalLines r9rMeasureExporter.relatedSpannersg sG 00 !#"$ ;%;D"L  +4//*; &O"+ E,77H %k:F 'I"9:MM(C 0C0C,DE&&0! k3{7K7K3LM((,(D(D_(b 6)(,(B(B?(` (* .! fc-2G.HI$0#49P9\%MM(C 8O4PQ%1#*+"6K"; <{K88[=R=R=^# S9N9N5OP&0>N&OO#**95({3  4&+5&G:K??#-k;;P;P#Q#QQ#Q&00K4I4I4T4TT $ ; ;K H($NN;7]; I+>> ssp = musicxml.m21ToXml.MeasureExporter._spannerStartParameters >>> ottava = spanner.Ottava(type='8va') >>> st = ssp('Ottava', ottava) Note that an ottava up in MusicXML is type "down", perhaps the opposite of what you might expect. It means that the music should be engraved "down" from where the sounding pitches would normally be engraved. >>> st['type'] 'down' >>> st['size'] 8 >>> cresc = dynamics.Crescendo() >>> st = ssp('DynamicWedge', cresc) >>> st['type'] 'crescendo' >>> st['spread'] 0 >>> diminuendo = dynamics.Diminuendo() >>> st = ssp('DynamicWedge', diminuendo) >>> st['type'] 'diminuendo' >>> st['spread'] 15 rrrrT)reverserrrr crescendorrrnienter sostenutorrr)r r rr!rshiftMagnitudeshiftDirectionr startTick startHeightrrrrrrr pedalType PedalType Sostenutorrr spannerClassr#posts r9r'MeasureExporter._spannerStartParameters sB#)'!2 8 #!"gnn5555,,.DL,,T,:DLD CV #!"gll3333!||D !#D : 9^ +!"h&;&;<<<<77DLww+%!"X99%*DN* '"$X& %[ (!"k&;&;<<<<||{44>>>*V 'V ||{44999$V  %V ~~&+]# r;cpSS0nUS:XaK[R(a![U[R5(deUR 5US'U$US:XaV[R(a![U[R 5(deURUS'URUS'U$US:Xat[R(a![U[R5(deURS :XaURUS 'U$S US 'UR(aS US 'U$US:Xa[R(a![U[R5(deUR [R"R [R"R$4;aS US'U$S US'U$)z Return a dict of the parameters for the end of this spanner required by MusicXML output. >>> ottava = spanner.Ottava(type='8va') >>> en = musicxml.m21ToXml.MeasureExporter._spannerEndParameters('Ottava', ottava) >>> en['type'] 'stop' >>> en['size'] 8 rrrrrrrrrrrrrrrr)r r rr!rrrendTick endHeightrrrrrrrrrrrs r9r%MeasureExporter._spannerEndParameterssw#)&!1 8 #!"gnn5555,,.DL0 /V #!"gll3333!zzD !#D & %^ +!"h&;&;<<<<ww+%!#X "#X99%*DN [ (!"k&;&;<<<<|| 5 5 : :K from spanners related to the object that should appear in the notations tag (slurs, slides, etc.) >>> n0 = note.Note('C') >>> n1 = note.Note('D') >>> trem = expressions.TremoloSpanner([n0, n1]) >>> m = stream.Measure() >>> m.insert(0, trem) >>> m.append(n0) >>> m.append(n1) >>> mex = musicxml.m21ToXml.MeasureExporter(m) >>> out = mex.objectAttachedSpannersToNotations(n0, objectSpannerBundle=m.spannerBundle) >>> out [] >>> mex.dump(out[0]) 3 >>> out = mex.objectAttachedSpannersToNotations(n1, objectSpannerBundle=m.spannerBundle) >>> mex.dump(out[0]) 3 rSlurslurrr)z bezier-offsetzbezier-offset2zbezier-xzbezier-yz bezier-x2z bezier-y2rrr Glissando continuousslide glissandorTremoloSpannertremoloz:spanner w/ a component that is neither a start nor an end.TrillExtensionz wavy-lineFT ornaments)r%appendArpeggioMarkSpannersToNotationsrrrr: setLineStyler\rCrrRrrr slideTyperlabelr&r numberOfMarksrr)ryrznoteIndexInChordr notationssbisSingleNoteOrFirstInChordr6rmxSlurr mxGlissandomxTrem mxWavyLine isFirstOrLastisFirstANDLast mxOrnGroupmxOrns r9!objectAttachedSpannersToNotations1MeasureExporter.objectAttachedSpannersToNotationsFs@$&  *$B))B  223)X&6!&;"*  --'BV_Fzz# 67+!!&-  ,''(*)C* <<+JJ{C ,=>3 66* JJxRZZ 1   V $'(*-- ,B|||+#!%.K OOHc"**o 6{{& S-=>zz#88''*288}K$03/ ; +   [ )--4-- 01BY'Fb../FKzz# 67+<<+JJ{C ,=>3 66*''QSU[]   V $2 -- 01B -J NN8S_ 5!M"Nzz#vw/ $ <<+NN; =yy~~ D(%)NNN662$(M%   Z (%$[1 xRZZ9vv.  ,=2@  -J"!!%(#   Z (r;c/nUbUnO URnU(dU$UR[R5Hn[ S5nUR U5(aUR SS5 SUlO+URU5(aUR SS5 OMiUR SS5 URU5 M UR[R5Hn[ S5nUR U5(aUR SS5 S UlO+URU5(aUR SS5 OMiUR SS5 URU5 M U$) a return a list of from spanners related to the object that should appear in the technical tag of the notations tag (hammer-on, pull-off etc.) >>> n0 = note.Note('C') >>> n1 = note.Note('D') >>> n2 = note.Note('F') >>> n3 = note.Note('E') >>> hammerOn01 = articulations.HammerOn([n0, n1]) >>> pullOff23 = articulations.PullOff([n2, n3]) >>> m = stream.Measure() >>> m.insert(0, hammerOn01) >>> m.insert(0, pullOff23) >>> m.append(n0) >>> m.append(n1) >>> m.append(n2) >>> m.append(n3) >>> mex = musicxml.m21ToXml.MeasureExporter(m) >>> out = mex.objectAttachedSpannersToTechnicals(n0, m.spannerBundle) >>> out [] >>> mex.dump(out[0]) H >>> out = mex.objectAttachedSpannersToTechnicals(n3, m.spannerBundle) >>> mex.dump(out[0]) OMIT_FROM_DOCS The other permutations of class and first/last: >>> out = mex.objectAttachedSpannersToTechnicals(n1, m.spannerBundle) >>> mex.dump(out[0]) >>> out = mex.objectAttachedSpannersToTechnicals(n2, m.spannerBundle) >>> mex.dump(out[0]) P z hammer-onrrHrrrQzpull-offP) rrrHammerOnrrr:r&rrPullOff)ryrzr technicalsr>r mxHammerOn mxPullOffs r9"objectAttachedSpannersToTechnicals2MeasureExporter.objectAttachedSpannersToTechnicalss1N  *$B))B -- 6 67B -Jzz#vw/"% 3vv. NN8S )   j )8-- 5 56B +Izz# fg.!$ 3 ff- MM(C (   i (7r;cUR[R5GHVnURU5(dMUn[ U[ R 5(aXnSnURS:XaVUR5upXhLa[S5nURSS5 OYXiLa[S5nURSS5 O7[S5nURS:waURSUR5 Ub\[U5S :d![U5S :Xa>[US 5S :a,URU5n URS [U 55 UcGMEURU5 GMY g) N non-arpeggionon-arpeggiaterrr arpeggiatenormalrrrr)rrArpeggioMarkSpannerhasSpannedElementrr Chordr noteExtremesrr:rr*rRr) ryrzr<r=r>amssub_obj mxArpeggiomin_notemax_noter)s r9r75MeasureExporter.appendArpeggioMarkSpannersToNotations*sA==!@!@AC((--G#u{{++/'+Jxx>)%(%5%5%7"&!()9!:JNN684(!()9!:JNN651$\2 88x'NN;9%3s8a"[R@U5nURCURD5n URGU 5 OURH(a [US5 U RJSLa"URMU 5n URGU 5 URNb5URQURN5nUHnURGU5 M [U[R 5(aURSXU5 URUXa5 URVb&[US5n[YURV5Ul-[S5nU RJSLaU R\S:XaSUl-O[_U R\5Ul-URiUUSS5 URGU5 [kU Rl5Hn[US5 M [U[R@5(aqURDRnbZURDRnRpS;a6URsURDRn5nURGU5 [uU Rv5S:Xa0URyU RvS5nURGU5 O[uU Rv5S:a[zR|"U R55RS 5n[R"URUR5nURyU5nURGU5 SnUS!Laa[U[R 5(aBURS":wa2[<R>"[R U5nURnOdXqLa`[U[R 5(aAURS":wa1[<R>"[R U5nURnSnUR0(aV[UR2[2R5(a-UR2RbUR2RnUcU(a[US#5nUcEUR[R5=n(aURUR5nOS$nOUnUS%:XaS&nUUl-U(a$URUU5 URUU5 URXaU5 US!Laa[U[R 5(aBURb5URUR5nUHnURGU5 M URXU5nUS!LaE[U Rv5H,unn URU US-5n!URU!5 M. U(a&[US'5n"UHn#U"RGU#5 M US!LaDURH4n$U$RZcMURU$5n%URGU%5 M6 URRGU5 U$![(a [*R-SU 35 GNff=f![`a? [U[Rb5(a[dRf"U5(aGNeef=f)(a Translate a music21 :class:`~music21.note.Note` or a Rest into a ElementTree, note element. Note that, some note-attached spanners, such as octave shifts, produce direction (and direction types) in this method. >>> n = note.Note('D#5') >>> n.quarterLength = 3 >>> n.volume.velocityScalar = 0.5 >>> n.style.color = 'silver' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> len(MEX.xmlRoot) 0 >>> mxNote = MEX.noteToXml(n) >>> mxNote >>> MEX.dump(mxNote) D 1 5 30240 half sharp normal >>> len(MEX.xmlRoot) 1 >>> r = note.Rest() >>> r.quarterLength = 1/3 >>> r.duration.tuplets[0].type = 'start' >>> mxRest = MEX.noteToXml(r) >>> MEX.dump(mxRest) 3360 eighth 3 2 eighth 3 eighth 2 eighth >>> len(MEX.xmlRoot) 2 >>> n.notehead = 'diamond' >>> n.articulations.append(articulations.Pizzicato()) >>> mxNote = MEX.noteToXml(n) >>> MEX.dump(mxNote) ... diamond Notes with complex durations need to be simplified before coming here otherwise they raise :class:`MusicXMLExportException`: >>> nComplex = note.Note() >>> nComplex.duration.quarterLength = 5.0 >>> mxComplex = MEX.noteToXml(nComplex) Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: Cannot convert complex durations to MusicXML. Try exporting with makeNotation=True or manually running splitAtDurations() TODO: Test with spanners rrNdg?>?rz.2fgrace)TFslashrzsteal-time-previouszsteal-time-followingz6Duration set as Grace while not being a GraceDuration Tz print-spacingr Pizzicato pizzicator rrestvoicerr7eighthrnoteSizedot)TNriF unspecifiedstemupnoStemnoner=)XrrrXrrNotResthasVolumeInformationvolumevelocityScalarr:rr GraceDurationrrfr*r8stealTimePreviousfractionToPercentstealTimeFollowingrQrrrdr4r$rcrrrtr castr pitchToXmlrrrisGrace durationXmlr' tieToXmlTiesetNoteInstrumentrrrRr&rr:r,rr(isFullMeasureRestrCrdotsr displayStatusrrr6tupletToTimeModification fractionsFractionaggregateTupletMultiplierlimit_denominatorTuplet denominator numerator stemDirection NoteStyle stemStylerr rgetStemDirectionForPitchespitchesr^r\dealWithNoteheadr3 beamsToXmlnoteToNotationsrCtupletToXmlTupletextendlyrics lyricToXmlr)&ryrr< chordParent addChordTagrmxNotechordOrNvelr graceElementartmxPitchr mxTieListmxTiemxVoicemxTypeunused_dotCounterrmxTimeModificationtupletFraction tempTupletr stem_stylemxStem closest_clefsdText nBeamsListmxBmxNotationsListrtup tupTagList mxNotationsmxNlyricObjmxLyrics& r9r^MeasureExporter.noteToXmlSsKr(1, (  H"H   v ) 6, x . .1133OO22>//0036(CC JJzc#Y 0 v!    a// 0 0%fg6L `77m+'Z=V=VW&&2%.#-#?#?A ''3%/#-#?#?A F& QWW%>%>$%F JJ .))Cckk) ;.*  vw ' 1g  tyy!$Aooagg.G MM' " XX vv & 99D ))!,J MM* % 55 ((/I" e$# a & &  " "1k : &$    * 1Gt223GL 99 6!1"FK 08  6:> f!&qvv  vu %"/ q$)) $ $GG&&2GG&&44 D..qww/A/ABL MM, ' qyy>Q !%!>!>qyy|!L  MM, - ^a &//0K0K0M22C2CD2I !)C)C)7)A)ACJ "&!>!>z!J  MM, -  5 x66**m;vvdllH5H$22Mq$,,//OO}4t||Q'AOOM  ( (x~~u??NN,,8!11J  $ /F$#+#=#=dii#HH<H)DDXEUEUVF!F&! FK fj1  4 f5 % (DLL11hnn6P!__X^^< %CMM#&&..qKP % #AII.3!33CQ? &&z2/ $V[9K&""3'' % $OO==(//(3 g& , F# y" `!!$Z[\Z]"^_ `^+ a++0I0I!0L0L  s&?A.b.c."ccAd d c URbURRcg[URR5S::agUR(agU(aUOUnUR 5nUcgUnSnURRH!nUR UR :XdMUn O Uc[ SUSUS35e[US5n URbU RSUR5 gg)z~ Insert tags if necessary, that is, when there is more than one instrument anywhere in the same musicxml . NrzInstrument instance z for note z not found in instrumentStreamrr6) r rrr getInstrumentclassSetr,rrr:) ryrrrsearchingObjectclosest_inst_or_none closest_instinstance_to_userL mxInstruments r9r!MeasureExporter.setNoteInstrument{s ;; $++">">"F  t{{++ , 1  88 CNKTU.<<>  ' .B KK00D}} 5 55"&1  ")&|nJqcA_` "&,7  ' ' 3   T?#?#? @ 4r;crURU5nURS5nUc [S5e[R"U5(abUR SS5 URS5nUbUR U5 URS5nUHnUR U5 M URS:wa[US5n[US 5nUR[R5n U b[U S 5(d[R"5n [R (a![#U [R5(deU R$S -n XR-n [&R("5n XlU R,Ul[1U R25UlU$) a Convert a Rest object to a with a tag underneath it. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> r = note.Rest(quarterLength=2.0) Give the rest some context: >>> m = stream.Measure() >>> m.timeSignature = meter.TimeSignature('4/4') >>> m.append(r) >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) 20160 half Now it is a full measure: >>> m.timeSignature = meter.TimeSignature('2/4') >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) 20160 Unless we specify that it should not be converted to a full measure: >>> r.fullMeasure = False >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) 20160 half With True or "always" it will be converted to full measure even if it does not match: >>> m.timeSignature = meter.TimeSignature('4/4') >>> r.duration.dots = 1 >>> r.fullMeasure = True >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) 30240 Note that if a measure has paddingLeft/paddingRight (such as a pickup) then a fullMeasure duration might not match the TimeSignature duration. The display-step and display-octave are set from a Rest's stepShift: >>> r = note.Rest() >>> r.stepShift = 1 >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) C 5 10080 quarter Clef context matters: >>> m = stream.Measure() >>> m.clef = clef.BassClef() >>> m.append(r) >>> mxNoteRest = MEX.restToXml(r) >>> MEX.dump(mxNoteRest) E 3 10080 quarter riz3Something went wrong -- converted rest w/o rest tagrrrrmr display-stepdisplay-octave lowestLiner)r^findr,r(rr:removefindall stepShiftrrr PitchClefrt TrebleClefr r rrrrhdiatonicNoteNumstepr&rRoctave) ryrr mxRestTagrmxDotsmxDot mxDisplayStepmxDisplayOctave currentClef midLineDNNrestObjectPseudoDNN tempPitchs r9rkMeasureExporter.restToXmlsav"KK'  )*_` `  $ $Q ' ' MM)U +[[(F! f%^^E*F e$  ;;! &y.AM(4DEO/0/B/B4>>/RK"'+|*L*L"oo/ !+t~~>>>>$//!3J",{{":  I(; %!*M #&y'7'7#8O  r;c 0/n[U[R5(aUR5 [ U5HUup4SUR ;a!UR URXCUS95 M6UR URXCUS95 MW U$)av Returns a list of tags, all but the first with a tag on them. And appends them to self.xmlRoot Attributes of notes are merged from different locations: first from the duration objects, then from the pitch objects. Finally, GeneralNote attributes are added. >>> ch = chord.Chord() >>> ch.quarterLength = 2 >>> b = pitch.Pitch('A-2') >>> c = pitch.Pitch('D3') >>> d = pitch.Pitch('E4') >>> e = [b, c, d] >>> ch.pitches = e >>> len(ch.pitches) 3 >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> len(MEX.xmlRoot) 0 >>> mxNoteList = MEX.chordToXml(ch) >>> len(mxNoteList) # get three mxNotes 3 >>> len(MEX.xmlRoot) 3 >>> MEX.dump(mxNoteList[0]) A -1 2 20160 half flat >>> MEX.dump(mxNoteList[1]) D 3 20160 half >>> MEX.dump(mxNoteList[2]) E 4 20160 half Test that notehead and style translation works: >>> g = pitch.Pitch('g3') >>> h = note.Note('b4') >>> h.notehead = 'diamond' >>> h.style.color = 'gold' >>> h.style.absoluteX = 176 >>> ch2 = chord.Chord([g, h]) >>> ch2.quarterLength = 2.0 >>> mxNoteList = MEX.chordToXml(ch2) >>> MEX.dump(mxNoteList[1]) B 4 20160 half diamond And unpitched chord members: >>> perc = percussion.PercussionChord([note.Unpitched(), note.Unpitched()]) >>> for n in MEX.chordToXml(perc): ... MEX.dump(n) B 4 10080 quarter B 4 10080 quarter Test articulations of chords with fingerings. Superfluous fingerings will be ignored. >>> testChord = chord.Chord('E4 C5') >>> testChord.articulations = [articulations.Fingering(1), ... articulations.Accent(), articulations.Fingering(5), articulations.Fingering(3)] >>> for n in MEX.chordToXml(testChord): ... MEX.dump(n) ... 1 ... 5 rir<r) rr r[ sortAscendingrCrrrjr^)ryr mxNoteListrrs r9rhMeasureExporter.chordToXmlsR a % % OO aLDAajj(!!$"5"5aYZ"5"[\!!$..TU."VW ! r;c[S5n[[[URUR -555UlU$)a Convert a duration.Duration object to a tag using self.currentDivisions >>> d = duration.Duration(1.5) >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEX.currentDivisions = 10 >>> mxDuration = MEX.durationXml(d) >>> MEX.dump(mxDuration) 15 r)rrRr7rrrr&)rydurrs r9r~MeasureExporter.durationXmls;Z( c%(=(=@Q@Q(Q"RST r;c[S5n[XSS5 URbD[US5n[ [ R "URR55Ul[XSS5 U$)a! Convert a :class:`~music21.pitch.Pitch` to xml. Does not create the tag. >>> p = pitch.Pitch('D#5') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxPitch = MEX.pitchToXml(p) >>> MEX.dump(mxPitch) D 1 5 rralterrimplicitOctave) rrXrrrRr numToIntOrFloatrr&)ryrrmxAlters r9r|MeasureExporter.pitchToXmlsc '" VV< << # '2Gv55all6H6HIJGL X7GHr;cURXUS9n[S5n[XS5 [XS5 [R"XESS/S9 U$)a Convert an :class:`~music21.note.Unpitched` to a with an subelement. >>> up = note.Unpitched(displayName='D5') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxUnpitched = MEX.unpitchedToXml(up) >>> MEX.dump(mxUnpitched) D 5 10080 quarter >>> graceUp = up.getGrace() >>> mxUnpitched = MEX.unpitchedToXml(graceUp) >>> MEX.dump(mxUnpitched) D 5 quarter r unpitchedrrrr)tagList)r^rrXr(insertBeforeElements)ryrpr<rr mxUnpitcheds r9rjMeasureExporter.unpitchedToXmlsQDS^_k*  .A 2BC$$V:vBVW r;c[S5n[XSS5 [XSS5 URb [XSS5 U$)a Converts a FretNote Object to MusicXML readable format. Note that, although music21 is referring to FretNotes as FretNotes, musicxml refers to them as frame notes. To convert between the two formats, each 'Fret-Note' must be converted to 'Frame-Note'. >>> fn = tablature.FretNote(string=3, fret=1, fingering=2) >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEXFretNote = MEX.fretNoteToXml(fn) >>> MEX.dump(MEXFretNote) 3 1 2 Without fingering! >>> fn2 = tablature.FretNote(string=5, fret=2) >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEXOtherFretNote = MEX.fretNoteToXml(fn2) >>> MEX.dump(MEXOtherFretNote) 5 2 z frame-notestringfret fingering)rrXr)ryfretNote mxFrameNotes r9 fretNoteToXmlMeasureExporter.fretNoteToXmlsD:l+  (K G    ) $XK Ur;cJUR(dg[S5n[US5n[UR5Ul[US5n[UR 5UlUR5H%nURU5nURU5 M' U$)a^ The ChordWithFretBoard Object combines chord symbols with FretNote objects. >>> myFretNote1 = tablature.FretNote(1, 2, 2) >>> myFretNote2 = tablature.FretNote(2, 3, 3) >>> myFretNote3 = tablature.FretNote(3, 2, 1) >>> guitarChord = tablature.ChordWithFretBoard('DM', numStrings=6, ... fretNotes=[myFretNote1, myFretNote2, myFretNote3]) >>> guitarChord.tuning = tablature.GuitarFretBoard().tuning >>> guitarChord.getPitches() [None, None, None, , , ] >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEXChordWithFret = MEX.fretBoardToXml(guitarChord) >>> MEX.dump(MEXChordWithFret) 6 4 3 2 1 2 3 3 1 2 2 Nframez frame-stringsz frame-frets) fretNotesrrrR numStringsr& displayFretsfretNotesLowestFirstrr)ry fretBoardmxFramemxFrameStrings mxFrameFrets thisFretNote mxFretNotes r9fretBoardToXmlMeasureExporter.fretBoardToXml-sH""'"#G_=!)"6"67!'=9  6 67 %::>> tup = duration.Tuplet(11, 8) >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxTimeMod = MEX.tupletToTimeModification(tup) >>> MEX.dump(mxTimeMod) 11 8 >>> tup.setDurationType('eighth', dots=2) >>> mxTimeMod = MEX.tupletToTimeModification(tup) >>> MEX.dump(mxTimeMod) 11 8 eighth ztime-modificationz actual-notesnumberNotesActualz normal-notesnumberNotesNormalz normal-typerz normal-dot) rrXdurationNormalrr:rr&rr)ryrr mxNormalTypers r9r(MeasureExporter.tupletToTimeModificationrs0%%89 .J]^ .J]^    )%&8-HL 233E3E3J3J KL !!&&*s11667A1<@8"!r;cSn[U[R5(aURS:wdIUR(d8UR c+UR (acURRS;aI[R"[RU5nSnURU5nURU5 USLaUb[US5(a~URS:wdIUR(d8UR c+UR (a>URRS;a#URU5nURU5 gggggg)aM Determine if an element needs to be added to this element (mxNote) and if it does then get the element from noteheadToXml and add it to mxNote. Complicated because the chordParent might have notehead set, which would affect every note along the way. Returns nothing. The mxNote is modified in place. FrXNrNTnotehead)rrrsr noteheadParenthesis noteheadFillr4r$rBr r{ noteheadToXmlrrt)ryrrrfoundANotehead mxNoteheads r9r MeasureExporter.dealWithNoteheads  q$,, ' 'x'))NN.**qww}}J/Nt||Q'A!N++A.J MM* % U "{'> Z00 ))X5#77#00<$88(..44JF!// <  j)G9 1(? "r;cl[S5nURnUcSnX2l[nU"XSS[R S9 U"XSS[R S9 UR (aLURR(a1[URR5nURSU5 U$) aG Translate a music21 :class:`~music21.note.NotRest` object such as a Note, or Chord into a `` tag. >>> n = note.Note('C#4') >>> n.notehead = 'diamond' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxN = MEX.noteheadToXml(n) >>> MEX.dump(mxN) diamond >>> n1 = note.Note('c3') >>> n1.style.color = 'red' >>> n1.notehead = 'diamond' >>> n1.noteheadParenthesis = True >>> n1.noteheadFill = False >>> mxN = MEX.noteheadToXml(n1) >>> MEX.dump(mxN) diamond >>> n1 = note.Note('c3') >>> n1.style.color = 'red' >>> n1.notehead = 'diamond' >>> n1.noteheadParenthesis = True >>> n1.noteheadFill = False >>> mxN = MEX.noteheadToXml(n1) >>> MEX.dump(mxN) diamond r rrfilledr rrr rB) rr r&rr*r8r4r$rBrCr:)ryrrnhrrBs r9rMeasureExporter.noteheadToXmls>Z( ZZ :B( QHn @Y@YZ QM+@!00 2 QWW]]"177==1E NN7E *r;c$SnURS:XalUS:Xa%URU5nURSS5 U$U[UR5S- :Xa#URU5nURSS5 U$URU5nU$)NrUrrrrr)rexpressionToXmlr:rnotes)ry arpeggioMark chordOrNoter< mxExpressions r9arpeggioMarkToMxExpression*MeasureExporter.arpeggioMarkToMxExpressions    .1$#33LA   2 "S):):%;a%??#33LA   / // =Lr;c/n[U[R5(Ga2UR(aURR(alURRR SLaIUR URURR55 USRSS5 UR(aURR(alURRR SLaIUR URURR55 USRSS5 U$[U[R[R45(aUR(aURR(aURRR SLapUR URURR55 URS:XaUSRSS5 U$USRSS5 U$)NTr&rabovebelowdown)rrTurnupperOrnamentalPitchrrrrr:lowerOrnamentalPitchGeneralMordentTrillornamentalPitchr)ry ornamentObjmxAccidentalMarkss r9ornamentToMxAccidentalMarks+MeasureExporter.ornamentToMxAccidentalMarkss+- k;#3#3 4 400#88CC#88CCQQUYY!((55k6V6V6a6ab""%))+w?00#88CC#88CCQQUYY!((55k6V6V6a6ab""%))+w?!  k&@&@+BSBS%T U U++#33>>#33>>LLPTT!((55k6Q6Q6\6\]((F2%b)--k7C! &b)--k7C  r;cSnSnSnUS:Hn/nUn UbUn U RHn [U [R5(a*URXU5n U cM9UR U 5 MLU(dMUUR U 5n U cMk[U [R 5(aLUc [S5nUR U 5 URU 5n U Hn UR U 5 M MUR U 5 M /nSnU RHn[U[R5(aX:XaUR U5 US- nM?U(dMH[U[R[R45(aMyUR U5 M UHn[U[R5(aM$[U[R5(aURS:aMU[U[R 5(a0Uc [S5nUR UR#U55 MUc [S5nUR UR%U55 M UR&b,UR)UR&5nUR+U5 Ub!UR+UR-X255 O UR+UR-X55 U(aUbUR/U5nOUbSnOUR/U5nU(aUc [S5nUR+U5 UUU4HnUcMUR U5 M U$)zj Take information from .expressions, .articulations, and spanners to make the tag for a note. Nrr6r technicalr)rr ArpeggioMarkrrrOrnamentrr*r FingeringrMrNrgStringIndicationrTechnicalIndicationarticulationToXmlTechnicalarticulationToXmlArticulationr' tieToXmlTiedrrHrR)ryrr<rmxArticulationsmxTechnicalMark mxOrnamentsr?r=rexpObjr mxAccidMarks mxAccidMarkapplicableArticulationsfingeringNumberaObjtiedListspannerTechnicalsr0s r9rMeasureExporter.noteToNotationss9 &6!&;"#%   "%K"--F&+":":;;#>>)9   '  .++#33F; 'fk&:&:;;"*&-k&: &&|488@!(4 #**;7(4$$\29.@EG--D$ 7 788"6+22481$++"$)?)?AVAV(WXX+2248.,D$ 7 788$ > >??DKKRSO$ A ABB"*&-k&:O&&t'F'Ft'LM"*&-o&>O&&t'I'I$'OP,( 55 ((/H   X &  "   TCCKb c   TCCAX Y &+*A $ G G T   $ $  $ G G J  &")+"6  " "#4 5!!A}  # r;c /nURS:XaSnO URn[S5nURSU5 URU5 URS:Xa.[S5nURSS5 URU5 U$)a0 returns a list of ties from a Tie object. A 'continue' tie requires two tags to represent. >>> tieObj = tie.Tie('continue') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> tieList = MEX.tieToXmlTie(tieObj) >>> for mxT in tieList: ... MEX.dump(mxT) continuerr'rr)rrr:r)rym21TiermusicxmlTieTypers r9rMeasureExporter.tieToXmlTies ;;* $$O$kkO &/* ;;* $ENE IIfg &   U #r;cURS:Xa/$/nURS:XaSnO URn[S5n[XA5 UR SU5 UR U5 URS:Xa.[S5nUR SS5 UR U5 URS:wa,URS:waUR SUR5 UR b_UR S UR 5 S nUR S :XaS nOUR S :XaSnOSnU(aUR SU5 U$)a^ In musicxml, a tie is represented in sound by the tie tag (near the pitch object), and the tag in notations. This creates the tag. Returns a list since a music21 "continue" tie type needs two tags in musicxml. List may be empty if tie.style == "hidden" >>> tieObj = tie.Tie('continue') >>> tieObj.id = 'tied1' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> tiedList = MEX.tieToXmlTied(tieObj) >>> for mxT in tiedList: ... MEX.dump(mxT) >>> tieObj.style = 'hidden' >>> tiedList = MEX.tieToXmlTied(tieObj) >>> len(tiedList) 0 hiddenrCrtiedrrrXrNrroverr underr= orientation)r$rrrr:rr)ryrD mxTiedListrEmxTiedrLs r9r5MeasureExporter.tieToXmlTieds*4 <<8 #I ;;* $$O$kkOv& 6?+&! ;;* $V_F JJvw '   f % <<8 # v(= JJ{FLL 1    ' JJ{F$4$4 5K7*$ !!W,%   =+6 r;c`URS;a/$URS;a[SUR-5eURS:XaSS/nO UR/n/nUGHn[S5nURSU5 URS [ U55 US:XGatUR nUS :XaS nURS [ R"U55 URbURS UR5 URnURn UcURSS5 O7US;aU S;aURSS5 OUS;aURSS5 US;aU S;aURSS5 OUS;aURSS5 UR S :XaURSS5 [US5n [U S5n [ UR5U l URbj[URR5n U (a[U S5n Xl [!URR"5Hn[U S5 M [US5n[US5n [ UR$5U l UR&bk[UR&R5nU(a[US5n UU l [!UR&R"5Hn[US5 M UR)U5 GM U$)a In musicxml, a tuplet is represented by a timeModification and visually by the tag. This method creates the latter. Returns a list of them because a startStop type tuplet needs two tuplet brackets. TODO: make sure something happens if makeTupletBrackets is not set. >>> tup = duration.Tuplet(11, 8) >>> tup.type = 'start' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxTup = MEX.tupletToXmlTuplet(tup) >>> len(mxTup) 1 >>> MEX.dump(mxTup[0]) 11 8 >>> tup.tupletActualShow = 'both' >>> tup.tupletNormalShow = 'type' >>> mxTup = MEX.tupletToXmlTuplet(tup) >>> MEX.dump(mxTup[0]) ... )NFr=)rr startStopz.Cannot create music XML from a tuplet of type rQrrtupletrrr.Trrz show-numberrr)rrr)ractualrS)rrz show-type line-shapecurvedz tuplet-actualz tuplet-numberz tuplet-typez tuplet-dotz tuplet-normal)rr,rr:rRrr*r8rtupletActualShowtupletNormalShowrrr&durationActualr:rrrrr)ryrR tupletIndex localTyperetList tupletTypemxTuplettBrackettastnsmxTupletActualmxTupletNumber actualType mxTupletTypeunused_countermxTupletNormal normalTypes r9r!MeasureExporter.tupletToXmlTupletsJ ;;+ +I ;;< <)@6;;NP P ;;+ % &)I I#Jx(H LL , LL3{#3 4W$!>>v%#H Y'66x@B##/LLf.>.>?----;LL7..3:L3LLL7..LL9**s6F/FLLf5,,LLh7>>V+LLx8",Ho!F!+NO!L&)&*B*B&C#((4!3F4I4I4N4N!OJ!'1.-'P ,6)*/0E0E0J0J*K"><@+L",Ho!F!+NO!L&)&*B*B&C#((4!3F4I4I4N4N!OJ!'1.-'P ,6 )*/0E0E0J0J*K"><@+L NN8 $o$pr;cSnURn[U[R5(aSURS:Xa [ S5nO7[ S5nURS:waUR SUR5 [U[R5(ap[U[R5(a)UR(a [ S5nO4[ S5nO(UR(a [ S 5nO [ S 5nUc8[/S Q5nUR5HupVXS;dM [ U5n O Uc"[RS U/5 [ S 5$URX!5 [US5(a)UR bUR SUR 5 [U[R"5(aQUR S[%UR55 UR&S;aUR&Ul[+X!5 [U[R,5(a,UR SS5 [%UR.5UlU$)a Convert a music21 Expression (expression or ornament) to a musicxml tag; return None if no conversion is possible. Expressions apply only to the first note of chord. >>> invTurn = expressions.InvertedTurn() >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(invTurn) >>> MEX.dump(mxExpression) >>> invDelayedTurn = expressions.InvertedTurn(delay=1.0) >>> invDelayedTurn.placement = 'below' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(invDelayedTurn) >>> MEX.dump(mxExpression) Some special types: >>> f = expressions.Fermata() >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(f) >>> MEX.dump(mxExpression) >>> f.shape = 'angled' >>> mxExpression = MEX.expressionToXml(f) >>> MEX.dump(mxExpression) angled >>> trem = expressions.Tremolo() >>> trem.numberOfMarks = 4 >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(trem) >>> MEX.dump(mxExpression) 4 >>> arp = expressions.ArpeggioMark() >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(arp) >>> MEX.dump(mxExpression) >>> arp.type = 'down' >>> mxExpression = MEX.expressionToXml(arp) >>> MEX.dump(mxExpression) >>> nonArp = expressions.ArpeggioMark('non-arpeggio') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxExpression = MEX.expressionToXml(nonArp) >>> MEX.dump(mxExpression) NrUrVrWrXrzdelayed-inverted-turnz inverted-turnz delayed-turnturn))r&z trill-mark)InvertedMordentzinverted-mordent)Mordentmordent)Shakeshake) Schleifer schleifer)Tremolor4)Fermatafermata)r/other-ornamentzno musicxml conversion for:rurr)angledsquaresingle)rrrr.rrr:r" InvertedTurn isDelayedrrrrrXrtrrsrRshaper&rrrr;)ry expressionmxrmappingrrs r9rMeasureExporter.expressionToXmltsp$$ j+":": ; ;.0-.\*??h.FF; 8 j+"2"2 3 3*k&>&>??'' !89B 1B'' 0B B :! # G < B( :  # #%BJ$O P+, , 2* :{ + + 0D0D0P FF; 4 4 5 j+"5"5 6 6 FF63z/ 0#77$** 2 * j+"5"5 6 6 FF68 $*223BG r;cSn[RH(n[X5(dM[RUn O UcSn[U5nURbUR SUR5 UR XA5 US:XaR[R(a![U[R5(deUR SUR5 US;aURXA5 US:XaT[R(a![U[R5(deURbURUlUS:XaUR bUR UlU$)a Returns a class (mxArticulationMark) that represents the MusicXML structure of an articulation mark. >>> a = articulations.Accent() >>> a.placement = 'below' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxArticulationMark = MEX.articulationToXmlArticulation(a) >>> MEX.dump(mxArticulationMark) >>> a = articulations.Staccatissimo() >>> a.placement = 'below' >>> mxArticulationMark = MEX.articulationToXmlArticulation(a) >>> MEX.dump(mxArticulationMark) Articulations can have style attached to them: >>> a = articulations.Doit() >>> a.style.lineShape = 'curved' >>> a.style.lineType = 'dashed' >>> a.style.dashLength = 2 >>> a.style.spaceLength = 1 >>> a.style.absoluteX = 5 >>> a.style.absoluteY = 2 >>> mxArticulationMark = MEX.articulationToXmlArticulation(a) >>> MEX.dump(mxArticulationMark) Nzother-articulationrz strong-accentr)doitfalloffplopscoopz breath-mark)r*ARTICULATION_MARKS_REVrrrr:rXr r r StrongAccentpointDirectionr8 BreathMarkrr& displayText)ryarticulationMarkmusicXMLArticulationNamermxArticulationMarks r9r4-MeasureExporter.articulationToXmlArticulationsMP$( 22A*..+5+L+LQ+O(3 $ +'; $$%=>  % % 1  " ";0@0J0J K -@ # 6!"2M4N4NOOOO  " "6+;+J+J K #'K K   0 C #} 4!"2M4L4LMMMM&&2*:*A*A"' $(< <$00<&6&B&B  #!!r;c0SnSnURXX45 g)z Sets four additional elements for line elements, conforms to entity %line-shape, %line-type, %dashed-formatting (dash-length and space-length) )rTrz dash-lengthz space-length) lineShaper dashLength spaceLengthNr}rPs r9r8MeasureExporter.setLineStyle2s S I ]Mr;cFSn[RH(n[X5(dM[RUn O UcSnUS;aSn[U5nURbUR SUR5 US:Xa[ R(a![U[R5(de[UR5Ul UR S[R"UR55 US;aURbURUl US;av[ R(a1[U[R[R 45(deUR S [R"UR"55 US :XaP[ R(a![U[R$5(de[UR&5Ul US :XaP[ R(a![U[R(5(de[UR&5Ul US :XaG[ R(a![U[R*5(deUR-XA5 US :XaG[ R(a![U[R.5(deUR1XA5 US:XaURbURUl UR3XA5 U$)a Returns a tag that represents the MusicXML structure of an articulation mark that is primarily a TechnicalIndication. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> a = articulations.UpBow() >>> a.placement = 'below' >>> mxTechnicalMark = MEX.articulationToXmlTechnical(a) >>> MEX.dump(mxTechnicalMark) >>> f = articulations.Fingering(4) >>> f.substitution = True >>> mxFingering = MEX.articulationToXmlTechnical(f) >>> MEX.dump(mxFingering) 4 Technical marks too specific to express in musicxml just get other-technical. >>> g = articulations.OrganIndication() >>> g.displayText = 'unda maris' >>> mxOther = MEX.articulationToXmlTechnical(g) >>> MEX.dump(mxOther) unda maris Same with technical marks not yet supported. TODO: support HammerOn, PullOff, Hole, Arrow. >>> h = articulations.HammerOn() >>> mxOther = MEX.articulationToXmlTechnical(h) >>> MEX.dump(mxOther) Nother-technical)holearrowrr alternate)handbellr)heeltoer substitutionrrbendharmonic)r*TECHNICAL_MARKS_REVrrrr:r r rr0rR fingerNumberr&r8rrOrganIndicationrr1rFretIndicationFretBendsetBendStringHarmonic setHarmonicrX)ryrmusicXMLTechnicalNamerr7s r9r3*MeasureExporter.articulationToXmlTechnicalHsV!%//A*..(2(F(Fq(I%0 ! ($5 ! !$5 5$5 !!"78  % % 1    -=-G-G H K /!"2M4K4KLLLL#&'7'D'D#EO    * 9 9:J:T:T U W !%D D$00< $4#?#?O $@ @!"2]5L5L5B5R5R5TUUUU    * 9 9:J:W:W X Z H ,!"2M4R4RSSSS#&'7'>'>#?O F *!"2M4P4PQQQQ#&'7'>'>#?O F *!"2M4J4JKKKK LL ; !J .!"2M4P4PQQQQ   _ ? !%6 6$00<#3#?#?O  ?=r;c[US5nURnUb[UR5UlUR (a [US5 UR bO[US5nUR n[[RU-5nURS[U55 URb'[US5n[UR5Ulgg)a} Sets the bend-alter SubElement and the pre-bend, release and with-bar SubElements when present. Called from articulationToXmlTechnical >>> from xml.etree.ElementTree import Element >>> from fractions import Fraction >>> MEXclass = musicxml.m21ToXml.MeasureExporter >>> a = articulations.FretBend(bendAlter=interval.Interval(2)) >>> mxh = Element('bend') >>> MEXclass.setBend(mxh, a) >>> MEXclass.dump(mxh) 2 >>> mxh = Element('bend') >>> a = articulations.FretBend(bendAlter=interval.Interval(2)) >>> a.preBend = True >>> MEXclass.setBend(mxh, a) >>> MEXclass.dump(mxh) 2 >>> mxh = Element('bend') >>> a = articulations.FretBend(bendAlter=interval.Interval(-2), release=Fraction(1, 10080)) >>> MEXclass.setBend(mxh, a) >>> MEXclass.dump(mxh) -2 >>> mxh = Element('bend') >>> a = articulations.FretBend(bendAlter=interval.Interval(-2), withBar='scoop') >>> MEXclass.setBend(mxh, a) >>> MEXclass.dump(mxh) -2 scoop z bend-alterNzpre-bendreleaser zwith-bar) r bendAlterrR semitonesr&preBendrr7rrr:withBar)mxhrbendAlterSubElementrreleaseSubElementquarterLengthValuedivisionsValuewithBarSubElements r9rMeasureExporter.setBends\)l;  '*5??';  $ << sJ ' << # *3 : !%  !=!=@R!RSN  ! !(C,? @ << # *3 ; %(%6  " $r;cH[US5(dgURS:Xa [US5 OURS:Xa [US5 URS:Xa [US5 gURS:Xa [US5 gURS :Xa [US 5 gg) a Sets the artificial or natural tag (or no tag) and zero or one of base-pitch, sounding-pitch, touching-pitch Called from articulationToXmlTechnical >>> MEXClass = musicxml.m21ToXml.MeasureExporter >>> a = articulations.StringHarmonic() >>> a.harmonicType = 'artificial' >>> a.pitchType = 'sounding' >>> from xml.etree.ElementTree import Element >>> mxh = Element('harmonic') >>> MEXClass.setHarmonic(mxh, a) >>> MEXClass.dump(mxh) :class:`~music21.articulations.Harmonic` is probably too general for most uses, but if you use it, you get a harmonic tag with no details: >>> b = articulations.Harmonic() >>> mxh2 = Element('harmonic') >>> MEXClass.setHarmonic(mxh2, b) >>> MEXClass.dump(mxh2) harmonicTypeN artificialnaturalr z base-pitchsoundingzsounding-pitchtouchingztouching-pitch)rtrr pitchType)rharms r9rMeasureExporter.setHarmonicsDt^,,     , sL )   ) + sI & >>V # sL ) ^^z ) s, - ^^z ) s, -*r;cURSLa/[R"URS9nUR U5$[ S5n[ X15 URX15 URX15 [US5n[US5nSUl URSS5 [US 5nURnURS :wa [S 5e[U5Ul URS ;a [S 5eURSUR5 UR!X5 UR#X15 UR$R'U5 U$)a Convert a NoChord object to an mxHarmony object (or a rest if .writeAsChord = True). Expected attributes of the NoChord object: >>> nc = harmony.NoChord() >>> nc.chordKind 'none' >>> nc.chordKindStr 'N.C.' Other values may not export: >>> nc.chordKindStr = '' >>> nc.write() Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: In part (None), measure (1): NoChord object's chordKindStr must be non-empty >>> nc.chordKind = None >>> nc.write() Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: In part (None), measure (1): NoChord object's chordKind must be 'none' To realize the NoChord as a rest: >>> nc2 = harmony.NoChord() >>> nc2.writeAsChord = True >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxNote = MEX.noChordToXml(nc2) >>> MEX.dump(mxNote) 10080 quarter Trrr root-stepCr&r=kindrrz)NoChord object's chordKind must be 'none'rNz/NoChord object's chordKindStr must be non-empty)rrrrrkrrrdrXrr&r: chordKindr,rR chordKindStrsetOffsetOptionalrrr)rycsrrmxRootmxStepmxKindcKinds r9r`MeasureExporter.noChordToXmls#R ??d " 2;;/A>>!$ $I& y% I* 9)Iv.FK0  62Iv.  <<6 !)*UV V%j ??j ()*[\ \ 62??+ r- )( I&r;cURSLaURU5$[R"U5nURUlUR USS9n[ R(a[U[5(deURS5nUbURU5 URS5nUbURU5 [S5n[US5nURSUR5 [UR 5UlUR$(aB[US 5n[UR$R&5UlURS S 5 UR((GaB[US 5n UR*(dU RS S5 [U S5n [UR(R,5U l[U S5n Sn UR(R.S:XaSn OUR S;aSn OUR S:XaHUR15R2UR(R4R2- S-S:XaSn OJSn OGUR15R2UR(R4R2- S-S:XaSn OSn XlUR7SU5 UR8R;U5 U$)u$ Convert a RomanNumeral object to either a chord (if .writeAsChord is True) or a Harmony XML Element. >>> rnI = roman.RomanNumeral('I', 'C') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEX.currentDivisions = 10 >>> listMxChords = MEX.romanNumeralToXml(rnI) >>> len(listMxChords) 3 >>> MEX.dump(listMxChords[1]) E 4 10 quarter If writeAsChord is False, we create a MusicXML 4.0 tag. This does not work in the current version of MuseScore (which only supports MusicXML 3.1) but outputs decently well in Finale. >>> rnI.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(rnI) >>> MEX.dump(mxHarmonyFromRN) 1 0 major major >>> complexRn = roman.RomanNumeral('#iio65', 'e-') >>> complexRn.followsKeyChange = True >>> complexRn.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(complexRn) >>> MEX.dump(mxHarmonyFromRN) 2 1.0 -6 minor diminished-seventh 1 >>> maj6 = roman.RomanNumeral('VI7', 'd') >>> maj6.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(maj6) >>> MEX.dump(mxHarmonyFromRN) 6 -1 natural minor major-seventh >>> min6 = roman.RomanNumeral('vi', 'd') >>> min6.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(min6) >>> mxHarmonyFromRN.find('.//numeral-mode').text 'melodic minor' >>> dim7 = roman.RomanNumeral('viiø65', 'd') >>> dim7.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(dim7) >>> mxHarmonyFromRN.find('.//numeral-mode').text 'harmonic minor' >>> mxHarmonyFromRN.find('kind').text 'half-diminished' >>> maj7 = roman.RomanNumeral('VII64', 'd') >>> maj7.writeAsChord = False >>> mxHarmonyFromRN = MEX.romanNumeralToXml(maj7) >>> mxHarmonyFromRN.find('.//numeral-mode').text 'natural minor' TFrrbassnumeralz numeral-rootr&z numeral-alterlocationrz numeral-keyrarbznumeral-fifthsz numeral-moder=major)minorr z natural minorz melodic minor zharmonic minorr)rrhrchordSymbolFromChordr rdr r rrrrrr: primaryFigurerR scaleDegreer&frontAlterationAccidentalrrfollowsKeyChangesharpsmoder pitchClasstonicrrr) ryrnrrrmxBass mxNumeral mxNumeralRootmxNumeralAlter mxNumeralKeymxNumeralFifths mxNumeralModemodeTexts r9rf!MeasureExporter.romanNumeralToXmlgsZ| ??d "??2& &  ) )" -II ))"U); ??i11 11'     V $'     V $I& "9n= &""2"23 0  ' '' ?CN"%b&B&B&H&H"IN    z6 2 666%i?L&&  6(7GHO#&rvv}}#5O &|^DMHvv{{g%"v-"1$GGI((266<<+B+BBbHAM.H.HGGI((266<<+B+BBbHBN.H/H!) I& I&r;TrcURSLaURU5$[S5n[X15 UR X15 UR X15 UR 5nURb([US5nURRUl OUb[US5n[US5n[UR5Ul URbD[US5n[[R "URR"55Ul O[$R'S/5 U$[US5n UR(=(d S n [*R,Hn [*R,U U :XdMU n M [U 5U l UR.S ;aU R1S UR.5 UR35n U S ;a[US 5n [U 5U l UR5SS9=(d UR5SS9nUbUbUR6UR6:wa[US5n[US5n[UR5Ul URbD[US5n[[R "URR"55Ul UR95nUHn[US5n[US5n[UR:5Ul [US5nUR<(a)[UR<R>R@5OSUl [US5n[URB5Ul M UREX5 URGX15 U(aURHRKU5 U$)a Convert a ChordSymbol object to either a chord (if .writeAsChord is True) or a Harmony XML Element. >>> cs = harmony.ChordSymbol() >>> cs.root('E-') >>> cs.bass('B-', allow_add=True) >>> cs.inversion(2, transposeOnSet=False) >>> cs.chordKind = 'major' >>> cs.chordKindStr = 'M' >>> cs >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEX.currentDivisions = 10 >>> mxHarmony = MEX.chordSymbolToXml(cs) >>> MEX.dump(mxHarmony) E -1 major 2 B -1 Now give function: >>> cs.romanNumeral = 'I64' >>> mxHarmony = MEX.chordSymbolToXml(cs) >>> MEX.dump(mxHarmony) I64 major 2 B -1 >>> hd = harmony.ChordStepModification() >>> hd.modType = 'alter' >>> hd.interval = -1 >>> hd.degree = 3 >>> cs.addChordStepModification(hd) >>> mxHarmony = MEX.chordSymbolToXml(cs) >>> MEX.dump(mxHarmony) I64 major 2 B -1 3 -1 alter Test altered chords: >>> f = harmony.ChordSymbol('F sus add 9') >>> f >>> mxHarmony = MEX.chordSymbolToXml(f) >>> MEX.dump(mxHarmony) F suspended-fourth 9 0 add MusicXML uses "dominant" for "dominant-seventh" so check aliases back... >>> dom7 = harmony.ChordSymbol('C7') >>> dom7.chordKind 'dominant-seventh' >>> mxHarmony = MEX.chordSymbolToXml(dom7) >>> MEX.dump(mxHarmony) C dominant set writeAsChord to not get a symbol, but the notes. Will return a list of notes. >>> dom7.writeAsChord = True >>> harmonyList = MEX.chordSymbolToXml(dom7) >>> len(harmonyList) 4 >>> MEX.dump(harmonyList[0]) C 3 10 quarter Trfunctionrrz root-alterz&need either a root or a _roman to showrrrrNr&)Nr inversionF)rrz bass-stepz bass-alterdegreez degree-valuez degree-alter0z degree-type)&rrhrrrdrXr_romanr romanNumeralfigurer&rRrrr rrrrrr CHORD_ALIASESrr:rrrgetChordStepModificationsrinterval chromaticdirectedmodTyperrrr)ryrrrcsRoot mxFunctionrrrrrxmlAliascsInv mxInversioncsBassrcsmhdmxDegree mxDegreeValue mxDegreeAlter mxDegreeTypes r9rd MeasureExporter.chordSymbolToXmlsz ??d "??2& &I& y% I* 9) 99 #Iz:J oo44JO   62F 4Ffkk*FK  ,$V\:"6#9#9&:K:K:Q:Q#RS  # #%M$N O Iv. &--H$$X.%7 .%j ??* , JJvr /   !$Y V[[FKK5O 62F 4Ffkk*FK  ,$V\:"6#9#9&:K:K:Q:Q#RS **,B!)X6H'x@M!$RYYM &x@MHJ R[[%:%:%C%C!DY\M &h >L #BJJL " r- )(  LL   *r;setSoundc$URUR:XagURUR- n[X@R-5nUb [ US5nO [ S5n[ U5UlU(aURSS5 U$)z If this object has an offset different from self.offsetInMeasure, then create and return an offset Element. If mxObj is not None then the offset element will be appended to it. Nr soundr) r rr7rrrrRr&r:)rym21ObjmxObjroffsetDifferenceInQloffsetDifferenceInDivisionsmxOffsets r9r!MeasureExporter.setOffsetOptionals ==D00 0%}}t/C/CC&)*>AVAV*V&W#  !%2Hx(H78  LL% (r;c[S5n[US5nURU5 UbJ[US5(a)URbUR SUR5 UR X$US9 U$)z Places the mxObj inside and sets if needed. * Changed in v8: added `setSound` keyword (see :meth:`setOffsetOptional`). rrrr)rrrrtrr:r)ryr r rr rs r9placeInDirection MeasureExporter.placeInDirectionstk* $[2BCu%  v{++0@0@0L V-=-=>  " "6 " Jr;c [S5n[X!5 UR[R;a[ X!R5nO&[ US5n[ UR5UlURX!5 URX!5nURXA5 URnUb5[ US5n[US-5nURS[ U55 URRU5 U$)ar return a nested tag: or whatever: >>> ppp = dynamics.Dynamic('ppp') >>> print('%.2f' % ppp.volumeScalar) 0.15 >>> ppp.style.relativeY = -10 >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxDirection = MEX.dynamicToXml(ppp) >>> MEX.dump(mxDirection) appends to score. Now with offset not zero. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> ppp.offset = 1.0 >>> mxDirection = MEX.dynamicToXml(ppp) >>> MEX.dump(mxDirection) 10080 rzother-dynamicsr)rrr8r* DYNAMIC_MARKSrrRr&rOrr volumeScalarr7r:rr)ryr mxDynamics mxThisDynamicr vSmxSound dynamicVolumes r9rlMeasureExporter.dynamicToXmlsVZ( z% 77j.. .&z77;M&z3CDM!$QWWM   . ++J:  +) ^^ > g6G SMM KK C $6 7 K(r;c[S5n[X!5 URX!5 URX!5nURR U5 U$)aJ returns a segno inside a direction-type inside a direction. appends to score >>> s = repeat.Segno() >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxSegnoDir = MEX.segnoToXml(s) >>> MEX.dump(mxSegnoDir) >>> s.id = 'segno0' >>> s.style.alignHorizontal = 'left' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxSegnoDir = MEX.segnoToXml(s) >>> MEX.dump(mxSegnoDir) segno)rrrOrrr)ryrmxSegnor s r9rnMeasureExporter.segnoToXml[sL8'"w& /++G;  K(r;c2UR(aU[S5n[X!5 URX!5 UR X!5nUR R U5 U$UR5nURUlURU5$)a> returns a coda inside a direction-type inside a direction IF coda.useSymbol is True; otherwise returns a TextExpression and appends to score: >>> c = repeat.Coda() >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxCodaDir = MEX.codaToXml(c) >>> MEX.dump(mxCodaDir) turn coda.useSymbol to `False` to get a text expression instead, and set enclosure to NO_ENCLOSURE to explicitly generate enclosure="none". >>> c.useSymbol = False >>> c.style.enclosure = style.Enclosure.NO_ENCLOSURE >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxCodaText = MEX.codaToXml(c) >>> MEX.dump(mxCodaText) Coda coda) useSymbolrrrOrrrgetTextExpressionr rv)ryr!mxCodar codaTes r9rpMeasureExporter.codaToXml~s|> >>V_F 6 (  # #F 1//=K LL   , ++-F KKFM++F3 3r;c/n/nSn/nSn[U[R5(a2UR5nURUlUR U5$[U[R 5(aUR(d URcSnOGURUR5 URUR5 URS5 UR5=(d SnO[U[R5(aSnURUR4HJnURS5 URUR5 URUR5 ML URR5=(d Sn[S5n [!X5 [#U5Hup[S5n [%U R&5U lU RU 5 [+U R,5Hn U R[S55 M U(dMzXZ(aM[/U S5n[1[2R4"US55UlM [7US 5(a$UR8(aU R;S S 5 OU R;S S 5 U(aUR=X5nO)[S 5n[!UU5 UR=UU5nU(a;[/US 5nUR;S[1[2R4"U555 UbUR>RU5 [U[R 5(aAURSS9b1URSS9nURUlUR U5nU$)ai returns a tag for a single tempo indication. note that **two** direction tags may be added to xmlroot, the second one as a textExpression, but only the first will be returned. >>> mm = tempo.MetronomeMark('slow', 40, note.Note(type='half')) >>> mm.style.justify = 'left' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxDirection = MEX.tempoIndicationToXml(mm) >>> MEX.dump(mxDirection) half 40 In this case, two directions were added to xmlRoot. Here is the other one: >>> MEX.dump(MEX.xmlRoot.findall('direction')[1]) slow >>> mm = tempo.MetronomeMark('slow', 40, duration.Duration(quarterLength=1.5)) >>> mxDirection = MEX.tempoIndicationToXml(mm) >>> MEX.dump(mxDirection) quarter 40 >>> mmod1 = tempo.MetricModulation() >>> mmod1.oldReferent = 0.75 # quarterLength >>> mmod1.newReferent = 'quarter' # type >>> mxDirection = MEX.tempoIndicationToXml(mmod1) >>> MEX.dump(mxDirection) eighth quarter >>> mmod1.newReferent = 'longa' # music21 type w/ different musicxml name >>> mxDirection = MEX.tempoIndicationToXml(mmod1) >>> MEX.dump(mxDirection) eighth long This is the case where only a sound tag is added and no metronome mark >>> mm = tempo.MetronomeMark() >>> mm.numberSounding = 60 >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxDirection = MEX.tempoIndicationToXml(mm) >>> MEX.dump(mxDirection) This is the case of a TempoText. >>> tt = tempo.TempoText('Andante') >>> mxDirection = MEX.tempoIndicationToXml(tt) >>> MEX.dump(mxDirection) Andante FrT metronomez beat-unitz beat-unit-dotz per-minuterrrrbwordsrr%)returnImplicit) rr%rqr#r rvrsnumberImplicitrrreferent getQuarterBPMrt oldMetronome newMetronomerrrCr:rr&rrrrRr rrtrr:rr)rytidursnumbershideNumericalMetro hideNumbersoundingQuarterBPMtesubmxMetrorrmxSubr mxPerMinuter mxWordsrunused_mxDirectionTexts r9rr$MeasureExporter.tempoIndicationToXmlsV"   b%// * *%%'B BI++B/ / b%-- . .  BII$5%)" BKK(ryy)!!%("$!1!1!3!:s  E22 3 3"' 9!!$' CLL)szz*: "$!>!>!@!GC +&w#dODAK(E+AFF3EJ NN5 !%*166]!w78&3wz}}(,? #&v'='=gaj'I#J  $ 2} % %".. KK u - KK t , // tag with a tag inside it. >>> rm = expressions.RehearsalMark('II') >>> rm.style.enclosure = 'square' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxRehearsal = MEX.rehearsalMarkToXml(rm) >>> MEX.dump(mxRehearsal) II rehearsalr) rrQrRrTr&rrCrr)ryrm mxRehearsalr s r9ry"MeasureExporter.rehearsalMarkToXmlgsd"k*  {/rzz? ++K<   = K(r;cXSnUR5nUH&n[U[R5(dM$Un O Ucg/n[U[R5(GaUR [R R[R R4;a#[S5/nUSRSS5 GO2UR [R R:Xa[S5/nUR[RR:XaUSRSS5 GOUR[RR:XaUSRSS5 GOUSRSS5 GOiUR [R R :Xa[S5[S5/nUSRSS 5 UR[RR:XaUS RSS5 OUR[RR:XaUS RSS5 OUS RSS5 Og[U[R"5(a"[S5/nUSRSS 5 OB[U[R$5(a"[S5/nUSRSS 5 OgUHnUR [R R[R R4;aURS S5 OURSS5 UR'Xa5nUR)XqS5 UR*R-U5 M W$)a Convert a PedalObject object (i.e. PedalBounce, PedalGapStart, PedalGapEnds) to a MusicXML tag with a tag inside it. Attributes like pedalForm are stored in the enclosing PedalMark spanner. >>> pm = expressions.PedalMark() >>> po = expressions.PedalBounce() >>> pm.addSpannedElements(po) >>> pm.pedalForm = expressions.PedalForm.Line >>> pm.pedalType = expressions.PedalType.Sustain >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxPedal = MEX.pedalObjectToXml(po) >>> MEX.dump(mxPedal) >>> pm = expressions.PedalMark() >>> po = expressions.PedalGapStart() >>> pm.addSpannedElements(po) >>> pm.pedalForm = expressions.PedalForm.Line >>> pm.pedalType = expressions.PedalType.Sustain >>> po.placement = 'above' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxPedal = MEX.pedalObjectToXml(po) >>> MEX.dump(mxPedal) >>> pm = expressions.PedalMark() >>> po = expressions.PedalGapEnd() >>> pm.addSpannedElements(po) >>> pm.pedalForm = expressions.PedalForm.Line >>> pm.pedalType = expressions.PedalType.Sustain >>> po.placement = 'below' >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxPedal = MEX.pedalObjectToXml(po) >>> MEX.dump(mxPedal) Nrrrchangerrsustainrr discontinueresumerrrr)getSpannerSitesrrr PedalBouncerrrrrr: SymbolAltrrSustainrSymbol PedalGapStart PedalGapEndrrCrr)rypopmspannersr#mxPedalsmxPedalr s r9r{ MeasureExporter.pedalObjectToXmlsh*.*,*<*<*>B"k3344 :"$ b+11 2 2|| 5 5 : :K? /<<;#8#8#@#@@QKOOFG4\\[%:%:%D%DDQKOOFK8 QKOOFI6 K55 6 6()H QKOOFM 2 K33 4 4()H QKOOFH -G|| 5 5 : :K>> MEX = musicxml.m21ToXml.MeasureExporter() >>> MEX.offsetInMeasure = 3.0 >>> cl = clef.BassClef() >>> methodToMx = MEX.clefToXml >>> mxAttributes = MEX.wrapObjectInAttributes(cl, methodToMx) >>> MEX.dump(mxAttributes) F 4 Also puts it in MEX.xmlRoot. If offsetInMeasure is 0.0 then nothing is done or returned: >>> MEX.offsetInMeasure = 0.0 >>> nothing = MEX.wrapObjectInAttributes(cl, methodToMx) >>> nothing is None True rN attributes)rrrr)ry objectToWrap methodToMx mxAttributesr s r9r&MeasureExporter.wrapObjectInAttributes$sPH   3 &|, <(E" L)r;cURcgURRcgURcgURRRUR5nUcg[ X5nU"[ XB55$)a  If this measure is part of a subsequent PartStaff in a joinable staff group (e.g. the left hand of a keyboard part), then look up the corresponding measure by number in the previous PartStaff, retrieve the `attr` value there, and compare it to `obj` by `comparison`. F)r rr rrP)ryrzattr comparison maybe_measurecomparison_wrappers r9 _matchesPreviousPartStaffInGroup0MeasureExporter._matchesPreviousPartStaffInGroupTsy ;;  ;; / / 7    $ <<DDSEVEVW  $S5!'-">??r;c n[S5nUR(d[XSS5 [XSSSS9 O[R(aUR ce[ UR 5Hdup4URS:XaMUS:a.[US5nUR(aURUl [XBSS5 [XBSSSS9 Mf URb%URS [UR55 URb&URS [UR55 O2URb%URS [UR55 URX!S S 5 UR!X!5 UR#X!5 UR%X!5 U$) z Translate a music21 :class:`~music21.note.Lyric` object to a tag. Lyrics have attribute list %justify, %position, %placement, %color, %print-object lyricsyllabicr&T)rL compositerelisionrr)rFr)r isCompositerXr r  componentsrCrir elisionBeforer& identifierr:rRrrCrdr^r\)rylyrr component mxElisions r9rMeasureExporter.lyricToXmlss['"~~ $R*j I $R&&T R}}000 )"-- 8 %%46 *7I >I ..)2)@)@ (ZT(VVX\]!9" == $ KKBMM 2 3 99 KK#bii. 1 ]] & KK#bmm"4 5  8 8 : G( g" %r;cp/nURH#nURURU55 M% U$)aN Returns a list of tags from a :class:`~music21.beam.Beams` object >>> a = beam.Beams() >>> a.fill(2, type='start') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxBeamList = MEX.beamsToXml(a) >>> len(mxBeamList) 2 >>> for b in mxBeamList: ... MEX.dump(b) begin begin ) beamsListr beamToXml)ryr3 mxBeamListbeamObjs r9rMeasureExporter.beamsToXmls4& G   dnnW5 6'r;c[S5n[X!5 SSSS.nURU;aX1RUlOqURS:XaHURS:XaSUlOIURS :XaS UlO1[ S UR-5e[ S URS 35eUR S[UR55 URX!5 URX!SS5 U$)ah Returns an ElementTree Element from a :class:`~music21.beam.Beam` object >>> a = beam.Beam() >>> a.type = 'start' >>> a.number = 1 >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> b = MEX.beamToXml(a) >>> b >>> MEX.dump(b) begin >>> a.type = 'continue' >>> b = MEX.beamToXml(a) >>> MEX.dump(b) continue >>> a.type = 'stop' >>> b = MEX.beamToXml(a) >>> MEX.dump(b) end >>> a.type = 'partial' >>> a.direction = 'left' >>> b = MEX.beamToXml(a) >>> MEX.dump(b) backward hook >>> a.direction = 'right' >>> a.id = 'beam1' >>> b = MEX.beamToXml(a) >>> MEX.dump(b) forward hook >>> a.direction = None >>> b = MEX.beamToXml(a) Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: partial beam defined without a proper direction set (set to None) >>> a.type = 'crazy' >>> b = MEX.beamToXml(a) Traceback (most recent call last): music21.musicxml.xmlObjects.MusicXMLExportException: unexpected beam type encountered (crazy) beambeginrCend)rrCrpartialrz backward hookrz forward hookz?partial beam defined without a proper direction set (set to %s)z"unexpected beam type encountered ()rfan) rrrr&rr,r:rRrr^rC)ry beamObjectmxBeam beamToTypes r9rvMeasureExporter.beamToXmlsbv*&",#  ??j ($__5FK __ )##v-- %%0, -U(()***4Z__4EQG   8S!2!234 f) E5A r;cURn[US5(dgURnURRnUc!U(aUSR U5(dgUR US5 g)zR Calls self.setBarline for the right side if the measure has a .rightBarline set. rightBarlineNrr)r"rtrrr setBarline)ryrrrs r9rMeasureExporter.setRightBarlinese KKq.)) __ {{//  #:a=+?+?+B+B  OOL' 2r;cURn[US5(dgURnURnUc!U(aUSR U5(dgUR US5 g)zP Calls self.setBarline for the left side if the measure has a .leftBarline set. leftBarlineNrr)r"rtrrrr)ryrrrs r9rMeasureExporter.setLeftBarline!s_ KKq-(( __ mm  #:a=+@+@+C+C  OOK 0r;cSnUc [S5nOM[U[R5(a[S5nUR U5nOUR U5n[ XA5 URSU5 UR(GaUS:Xa0URSRUR5(aSnO8US:Xa0URSRUR5(aSnOS nU(a[S 5nURSRn[US5nUS :XaS nUS SHn US [U 5-- nM URSU5 URSU5 URU5 UbURU5 URRU5 U$)zX sets either a left or right barline from a bar.Barline() object or bar.Repeat() object Nbarlinerrrrrrr=endingrrrsrr)rrr Repeat repeatToXml barlineToXmlrr:rrr"r numberRangerRrr) ryrpositionmxRepeat mxBarline endingTypemxEnding numberList numberStrnums r9rMeasureExporter.setBarline2s  ? *I'3::..#I. ++G4 --g6 y* j(+ ???6!dooa&8&@&@&M&M$ W$);)B)B4;;)O)O#  "8,!__Q/;;  1 . # "I%ab>Cs3x/I* Xy1 VZ0  *     X & I&r;c[S5n[US5nUR5UlURbUR SUR5 U$)a Translate a music21 bar.Bar object to an mxBar while making two substitutions: double -> light-light and final -> light-heavy as shown below. >>> b = bar.Barline('final') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxBarline = MEX.barlineToXml(b) >>> MEX.dump(mxBarline) light-heavy >>> b.location = 'right' >>> mxBarline = MEX.barlineToXml(b) >>> MEX.dump(mxBarline) light-heavy rz bar-styler)rrmusicXMLBarStyler&rr:)ry barObjectr mxBarStyles r9rMeasureExporter.barlineToXmlisP,I&  ;7 #446     ) MM*i&8&8 9r;cN[S5nURS:XaURSS5 ODURS:XaURSS5 O![R"SUR5eUR b%URS[ UR 55 U$) aO returns a tag from a barline object. >>> b = bar.Repeat(direction='end') >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> mxRepeat = MEX.repeatToXml(b) >>> MEX.dump(mxRepeat) >>> b.times = 3 >>> mxRepeat = MEX.repeatToXml(b) >>> MEX.dump(mxRepeat) r rrrr}backwardzcannot handle direction format:times)rrr:r BarExceptionrrR)ryrrs r9rMeasureExporter.repeatToXmls 8$ ;;' ! LLi 0 [[E ! LLj 1""#DakkR R 77  LL#agg, /r;ctURn[S5n[RUlUR b$URUR R :waA[US5n[UR5Ul URUR lURbKURURS5(d*URURUR55 URbJURURSSS9(d*URURUR55 [!UR#[$R&55nU(a#URURUS55 UR(b*URUR+UR(55 UR#[,R.5nU(a%USnURUR1U55 UR2b*URUR5UR255 UR75nUbURU5 [9U5S:dUR:(aUR<RU5 U$)z creates an tag at the start of the measure. We create one for each measure unless it is identical to self.parent.mxAttributes r[ divisionsr-r ratioEqual)rbr)r"rrrrr rrrRr&r-rerr}rr~rrrSenzaMisuraTimeSignaturer r|r StaffLayoutstaffLayoutToXmlStaffDetailsrintervalToXmlTranspose measureStylerrgr)ryrr^ mxDivisionssmtsfoundslmxMeasureStyles r9r6MeasureExporter.setMxAttributesObjectForStartOfMeasures KK|, !) < < ;; $"7"74;;;T;T"T$\;?K"4#8#89K (,(=(=DKK % NN &==NNN    6 6q~~ F G OO '==OO_>    7 7 H IA(()G)GHI     7 7Q @ A 66    qvv 6 7$$V%7%78 qB    A A" E F  % % 1    ; ;D Element or None according to the contents of the Stream. Currently, only multiple-rest is supported. NrMultiMeasureRestz multiple-restz use-symbolsrrbz measure-style) r"rrrrHrr useSymbolsr:rRnumRestsr&r)ryrrmxMultipleRestrestshasMMR firstRestMMRs r9rMeasureExporter.measureStyles KK$$TYY/ 1X--.@AF%ay ''a11%,_%=N#..&**=%@&**=$?*-l.C.C*DN'  %$_5N  ! !. 1r;c[S5nURSLaURSS5 OURSS5 [RR nUR URUR4;a'[US5nUR RUl URb&[US5n[UR5Ul U$)a Convert a :class:`~music21.layout.StaffLayout` object to a element. >>> MEX = musicxml.m21ToXml.MeasureExporter() >>> sl = layout.StaffLayout() >>> sl.staffLines = 3 # tenor drums? >>> sl.staffType = stream.enums.StaffType.CUE >>> sl.hidden = True >>> mxDetails = MEX.staffLayoutToXmlStaffDetails(sl) >>> MEX.dump(mxDetails) cue 3 z staff-detailsTrarbrz staff-typez staff-lines)rrHr:r"r StaffType staffTypeREGULAROTHERrr8r& staffLinesrR)ryrmxStaffDetailsr mxStaffType mxStaffLiness r9r,MeasureExporter.staffLayoutToXmlStaffDetailss,!1    %   ~t 4   ~u 5LL**  ):):IOO(L L$^\BK*44::K   ! ! -%nmDL #K$:$: ;L  r;c[S5n[X!5 [U[R5(a,[ US5nUR bUR UlU$[SURR555nUR(a[RRU5nUH=upV[ US5n[U5Ul[ US5n[U5UlM? UR(aURSS5 O,UR S:waURSUR 5 UR#X!5 UR%X!5 U$) a Returns a single