rh .SrSSKJr SSKrSSKrSSKrSSKrSSKJ r SSKJ r SSKJ r SSK J r \ R"S5r\R (aSSS SS .SS jjjrSS jrSS jrSSSjjr"SS\R*5rg)zz This module contains tools for using MuseScore to do conversions from music21. It was formerly mostly in subConverters. ) annotationsN)common)defaults) environment)SubConverterExceptionzconverter.museScoreT)dpi trimEdges leaveMarginc [SnU(d [S5eUR5(d[SUS3-5eU(dSnOUS=(d SnURSU-5n[ U5US[ U5/n U(aU R S [ U5/5 UbU R S [ U5/5 [ R"S 5n [ R"S 5n [R"5(a[R"5S :XaVU cS[ RS 'U c=[ [R"5R55[ RS 'Uc*U R S [ [R 5/5 [R"R%U 5 [R"5(a][R"5S :XaDU c[ RR'S 5 U c[ RR'S 5 US:Xa [)U5$U$)ae Take the output of the conversion process and run it through MuseScore to convert it to a png. * dpi: specifies the dpi of the output file. If None, then the default is used. * trimEdges: if True (default) the image is trimmed to the edges of the music. * leaveMargin: if trimEdges is True, then this number of pixels is left around the trimmed image. musescoreDirectPNGPathzTo create PNG files directly from MusicXML you need to download MuseScore and put a link to it in your .music21rc via Environment.z+Cannot find a path to the 'mscore' file at z -- download MuseScorepngr.z-oz-Tz-rQT_QPA_PLATFORMXDG_RUNTIME_DIRnix offscreen) environLocalrexists with_suffixstrextendosgetenvrrunningInNotebook getPlatformenvironr EnvironmentgetRootTempDirrjupyterImageDpi fileToolsrunSubprocessCapturingStderrpopfindNumberedPNGPath) fp subformatsrr r keywords museScorePathsubformatExtensionfpOut museScoreRunprior_qt prior_xdgs U/home/james-whalen/.local/lib/python3.13/site-packages/music21/converter/museScore.pyrunThroughMuseScorer.s$!!9:M # EF F    ! !# 956 78 8 "']3e NN3!33 4E &D#e*=LT3{#345 T3s8,-yy*+H +,I !!    5 (0; ,- 03K4K4K4M4\4\4^0_ ,- ;   s8+C+C'D E F 11,? !!f&8&8&:e&C   JJNN, -   JJNN, -U""5)) c.[U5nURS5(d[SU35eUSS[S5-nSH;n[R "US-U-S-5nUR 5(dM9Us $ [SUSUS 3S -5e) z Find the first numbered file path corresponding to the provided unnumbered file path ending in ".png". Raises an exception if no file can be found. Renamed in v7. Returns a pathlib.Path .png"inputFp must end with ".png"; got N)101001000100001-zNo png file for z (such as z-1.png) was found. zThe conversion to png failed)rendswith ValueErrorlenpathlibPathrIOError)inputFppath_without_extensionsearch_extension search_paths r-r#r#hs'lG   F # #=gYGHH$%6b3v;&67?ll#9C#?BR#RU[#[\      @  7):.D-EEYZ ( ) r/c URnURS5(d[SU35eURS5nUS:Xa[ SU35eUSUn[ [ URRUS35SS 95SnU$) z Find the last numbered file path corresponding to the provided NUMBERED file path ending in ".png". Raises an exception if no file can be found. For instance, if there was a file named abc-01.png it might find abc-22.png. r1r2r9r3z2inputFp must end with "-0001.png" or similar; got Nz-*.pngcUR$N)name)ps r-!findLastPNGPath..s!&&r/)key) rGr:r;rfindrlistsortedparentglob)r@ inputFpStr dash_location base_name last_names r-findLastPNGPathrUsJ   v & &=gYGHH$$S)M#@ J  >M*IVGNN//9+V0DE 023357I r/c@URnURS5(d[SU35eUc [U5nUR S5nUS:Xa[SU35eSn[ U5U- U- S- nURUS-US-U-n[ U5nXu4$)z Return a 2-tuple of the maximum PNG number and the number of digits used to specify the PNG (for MuseScore generated PNGs, for use in the widget) r1z"firstFp must end with ".png"; got r9r3z2firstFp must end with "-0001.png" or similar; got )rGr:r;rUrLr<int)firstFplastFprQrR suffix_len num_digits num_string last_numbers r- findPNGRanger`sJ   v & &=gYGHH ~ )$$S)M@ J  JZ=0:=AJ]Q.}q/@:/MNJj/K  $$r/c\rSrSrSrSrg)TestcH[R"5nSHnSU-S-nURSSS9nURSU5n[R "XE5 [ U5nUR[U5U5 [R"U5 M URSSS9nURSS5n[R "XE5 UR[5 [ U5 SSS5 [R"U5 g!,(df  N%=f)zt Testing findNumberedPNGPath() with files of lengths that create .png files with -1, -01, -001, and -0001 in the fp )r4r5r6r7r9r1F)suffix returnPathlibz -0000001.pngN) rr getTempFilereplacerrenamer# assertEqualrremove assertRaisesr?)selfenvext_basepng_exttmp tmpNumberedpngFp1s r- pngNumberingTest.pngNumberings %%'0HHnv-G//u/EC++fg6K IIc '(-F   S[+ 6 IIk "1ooV5oAkk&.9  ##   w '  ,( +( 's ( D D!N)__name__ __module__ __qualname____firstlineno__rt__static_attributes__rvr/r-rbrbsr/rb)rv)rz int | Noner boolr rYreturn pathlib.Path)r@zstr | pathlib.Pathr}r~)r@r~r}r~rF)rZr~r[zpathlib.Path | Noner}ztuple[int, int])__doc__ __future__rrr=typingtunittestmusic21rrrmusic21.exceptions21rrr TYPE_CHECKINGr.r#rUr`TestCaserbrvr/r-rs# 6&&'<= ??D D  D  D  DDR00!%% % %%88  r/