j8dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z dd lm Z ej d Z gd Z d d ddddddddd ZdddddddddZd Zd!d"d#d$d%d&d'd(d)d*d+d+d,d-d.ZGd/d0ejZGd1d2ejZGd3d4e jZGd5d6eZGd7d8eZGd9d:ejZGd;dz Classes and functions for creating and manipulating dynamic symbols. Rather than subclasses, the :class:`~music21.dynamics.Dynamic` object is often specialized by parameters. ) annotationsN)base)common) environment) exceptions21)spanner)styledynamics)pppppppppppppppppppppmpmfffpsfffffffffffffffffffff pianississimo pianissimopiano mezzopiano mezzoforteforte fortepiano sforzando fortissimo fortississimo) rrrrrrrrrrzextremely soft very softsoftzmoderately softzmoderately loudloudz very loudzextremely loud)rrrrrrrrc||dkrdS|dkrdS|dkrdS|dkrd S|d krd S|d krd S|dkrdS|dkrdS|dkrdSdS)aX Given a decimal from 0 to 1, return a string representing a dynamic with 0 being the softest (0.01 = 'ppp') and 1 being the loudest (0.9+ = 'fff') 0 returns "n" (niente), while ppp and fff are the loudest dynamics used. >>> dynamics.dynamicStrFromDecimal(0.25) 'pp' >>> dynamics.dynamicStrFromDecimal(1) 'fff' Nrng)\(?r g{Gz?rgp= ף?rg ףp= ?r?rg?rg?r?rr)r)s /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/dynamics.pydynamicStrFromDecimalr.5s yAFFs Tv Tu Tt Ts St Tt Ss Stur*gg?g333333??gffffff?g?g?gffffff?g?g333333?r+gffffff?)Nr)r rrrrrrrrrrrceZdZdS)DynamicExceptionN)__name__ __module__ __qualname__r,r/r-r2r2jsDr/r2ceZdZUdZdZejZddgZddddZ d e d <dfd Z d Z dZ dZee edZdZdZeeedZxZS)Dynamica Object representation of Dynamics. >>> pp1 = dynamics.Dynamic('pp') >>> pp1.value 'pp' >>> pp1.longName 'pianissimo' >>> pp1.englishName 'very soft' Dynamics can also be specified on a 0 to 1 scale with 1 being the loudest (see dynamicStrFromDecimal() above) >>> ppp = dynamics.Dynamic(0.15) # on 0 to 1 scale >>> ppp.value 'ppp' >>> print(f'{ppp.volumeScalar:.2f}') 0.15 Note that we got lucky last time because the dynamic 0.15 exactly corresponds to what we've considered the default for 'ppp'. Here we assign 0.98 which is close to the 0.9 that is the default for 'fff' -- but the 0.98 will be retained in the .volumeScalar >>> loud = dynamics.Dynamic(0.98) # on 0 to 1 scale >>> loud.value 'fff' >>> print(f'{loud.volumeScalar:.2f}') 0.98 Transferring the .value ('fff') to a new Dynamic object will set the volumeScalar back to 0.9 >>> loud2 = dynamics.Dynamic(loud.value) >>> loud2.value 'fff' >>> print(f'{loud2.volumeScalar:.2f}') 0.90 Custom dynamics are possible: >>> myDyn = dynamics.Dynamic('rfzsfmp') >>> myDyn.value 'rfzsfmp' >>> print(myDyn.volumeScalar) 0.5 >>> myDyn.volumeScalar = 0.87 >>> myDyn.volumeScalar 0.87 Dynamics can be placed anywhere in a stream. >>> s = stream.Stream() >>> s.insert(0, note.Note('E-4', type='half')) >>> s.insert(2, note.Note('F#5', type='half')) >>> s.insert(0, dynamics.Dynamic('pp')) >>> s.insert(1, dynamics.Dynamic('mf')) >>> s.insert(3, dynamics.Dynamic('fff')) >>> #_DOCS_SHOW s.show() .. image:: images/dynamics_simple.* :width: 344 longName englishNamez the name of this dynamic in Italian. >>> d = dynamics.Dynamic('pp') >>> d.longName 'pianissimo' z the name of this dynamic in English. >>> d = dynamics.Dynamic('pp') >>> d.englishName 'very soft' a} Staff placement: 'above', 'below', or None. A setting of None implies that the placement will be determined by notation software and no particular placement is demanded. This is not placed in the `.style` property, since for some dynamics, the placement above or below an object has semantic meaning and is not purely presentational. For instance, a dynamic placed between two staves in a piano part implies that it applies to both hands, while one placed below the lower staff would apply only to the left hand. )r9r: placementzdict[str, str] _DOC_ATTRNc  tjdi|d|_d|_d|_d|_t |ts||_t||_ n||_ d|j _ d|j _ d|_ dS)Niir,)super__init__ _volumeScalarr9r:_value isinstancestrr.valuer absoluteX absoluteYr;)selfrDkeywords __class__s r-r?zDynamic.__init__s$$8$$$ "  %%% !&D .u55DJJDJ # " r/c*t|jSN)rCrDrGs r- _reprInternalzDynamic._reprInternals4:r/c|jSrK)rArLs r- _getValuezDynamic._getValues {r/c||_|jtvrt|j|_nd|_|jtvrt|j|_dSd|_dSrK)rA longNamesr9 englishNamesr:rGrDs r- _setValuezDynamic._setValues] ;) # #%dk2DMM DM ;, & &+DK8D   #D   r/a Get or set the value of this dynamic, which sets the long and English names of this Dynamic. The value is a string specification. >>> p = dynamics.Dynamic('p') >>> p.value 'p' >>> p.englishName 'soft' >>> p.longName 'piano' >>> p.value = 'f' >>> p.value 'f' >>> p.englishName 'loud' >>> p.longName 'forte' )docc|j|jS|jtvrt|jS|j}d|vr |dd}|ddkr |dd}|tvr t|StdS)Nsz)r@rAdynamicStrToScalar)rG thisDynamics r-_getVolumeScalarzDynamic._getVolumeScalars   )% % [. . .%dk2 2+Kk!!)!""o 2#%%)#2#. 000)+66)$//r/ctj|rd|cxkrdkr nn ||_dStd|)NrrXz cannot set as volume scalar to: )risNumr@r2rSs r-_setVolumeScalarzDynamic._setVolumeScalar(sR <   O1?????????!&D   "#Me#M#MNN Nr/a Get or set the volume scalar for this dynamic. If not explicitly set, a default volume scalar will be provided. Any number between 0 and 1 can be used to set the volume scalar, overriding the expected behavior. As mezzo is at 0.5, the unit interval range is doubled for generating final output. The default output is 0.5. >>> d = dynamics.Dynamic('mf') >>> d.volumeScalar 0.55... >>> d.volumeScalar = 0.1 >>> d.volumeScalar 0.1 >>> d.value 'mf' int(volumeScalar \* 127) gives the MusicXML tag >>> xmlOut = musicxml.m21ToXml.GeneralObjectExporter().parse(d).decode('utf-8') >>> print(xmlOut) ... rK)r3r4r5__doc__classSortOrderr TextStyle _styleClass _DOC_ORDERr<__annotations__r?rMrOrTpropertyrDr]r` volumeScalar __classcell__rIs@r-r7r7os@@BN/Km,J #!!I>2 $ $ $ HY     E,000&OOO8,.>!E ! ! ! LLLLLr/r7c"eZdZdZfdZxZS) DynamicWedgez9 Common base-class for Crescendo and Diminuendo. crtj|i|d|_d|_d|_d|_dS)NbelowF)r>r?typer;spreadnienterGspannedElementsrHrIs r-r?zDynamicWedge.__init__YsA/6X666     r/r3r4r5rar?rirjs@r-rlrlTsB         r/rlc"eZdZdZfdZxZS) Crescendoz A spanner crescendo wedge. >>> d = dynamics.Crescendo() >>> d.spread 15 >>> d.spread = 20 >>> d.spread 20 >>> d.type 'crescendo' cHtj|i|d|_dS)N crescendor>r?rprss r-r?zCrescendo.__init__ss*/6X666 r/rurjs@r-rwrwesB           r/rwc"eZdZdZfdZxZS) Diminuendozv A spanner diminuendo wedge. >>> d = dynamics.Diminuendo() >>> d.spread = 20 >>> d.spread 20 cHtj|i|d|_dS)N diminuendorzrss r-r?zDiminuendo.__init__s*/6X666  r/rurjs@r-r|r|xsB!!!!!!!!!r/r|ceZdZdZdZdZdS) TestExternalTc^td}|jr|dSdS)Nr)r7show)rGas r- testSinglezTestExternal.testSingles2 FOO 9  FFHHHHH  r/cddlm}|}d}tD],}t |}||||dz }-|jr|dSdS)z: present each dynamic in a single measure rstreamN)music21rStream shortNamesr7insertr)rGrrodynStrbs r- testBasiczTestExternal.testBasics #""""" MMOO    FA HHQNNN FAA 9  FFHHHHH  r/N)r3r4r5rrrr,r/r-rrs7 D     r/rc2eZdZdZdZdZdZdZdZdS)TestcBddlm}||tdS)Nr) testCopyAll)music21.test.commonTestrglobals)rGrs r-testCopyAndDeepcopyzTest.testCopyAndDeepcopys0777777 D'))$$$$$r/ct}|jJtd}||jd||jd||jddS)Nrrr%)r7r9 assertEqualrDr:)rGnoDynrs r-rzTest.testBasicsr ~%%% T]] 4((( l333 55555r/cddlm}ddlm}|d}|jd|j}|t|d|jd|j }|t|ddS)Nr)corpus)r zopus41no1/movement2#) rrr parsepartsflattengetElementsByClassr7rlenrl)rGrr rrs r-testCorpusDynamicsWedgezTest.testCorpusDynamicsWedges""""""$$$$$$ LL. / / GAJ   3 3H4D E E Q$$$ GAJ   3 3H4I J J Q#####r/cddlm}td}||d}d}|||d|dS)Nr)m21ToXmlrzutf-8z

rY)music21.musicxmlrr7GeneralObjectExporterrdecodeassertNotEqualfind)rGrdxmlOutmatchs r-testMusicxmlOutputzTest.testMusicxmlOutputs{------ CLL//1177::AA'JJ FKK..F;;;;;r/c6ddlm}ddlm}|}gd}t dD]d}t ||t |z}||||dedS)Nrrnote)rrrrr8c1) rrrrranger7rappendNote)rGrrrW selectionsirs r-testDynamicsPositionAzTest.testDynamicsPositionAs""""""      MMOO--- r & &A 1s:#6788A HHQKKK HHTYYt__ % % % % & &r/cddl}ddlm}ddlm}ddlm}|}t dD]}||dz}|| d || d ||| |j}|D]p}d t d D} | | | dd} | D]3} td} d| j_|| | 4qdS)Nrrr)layoutrX)numberT)isNewwhole)rpcg|]}|dzS)r0r,).0xs r- z.Test.testDynamicsPositionB..s333Aq4x333r/rr)randomrrrrrrMeasurer SystemLayoutRestrshuffler7r rFr) rGrrrrrWrmstream_iteratoroffsetsrrs r-testDynamicsPositionBzTest.testDynamicsPositionBsp """"""      """""" MMOOq  Aa!e,,A HHV((t(44 5 5 5 HHTYYGY,, - - - HHQKKKK..v~>>   A33r333G NN7 # # #bqbkG  DMM$&!A    r/N) r3r4r5rrrrrrr,r/r-rrsn%%%666 $ $ $<<< & & &r/r__main__) ra __future__runittestrrrrrrr Environment environLocalrrQrRr.r[Music21Exceptionr2 Music21Objectr7Spannerrlrwr|TestCaserrrer3mainTestr,r/r-rs#""""" &{&z22 QQQ #     $ & & ("(("(** F           &     |4   a a a a a d a a a J7?"        & ! ! ! ! ! ! ! !"8$0AAAAA8 AAAN, -  zNNNGTr/