jdZddlmZddlZddlmZddlmZGddejeZ Gdd ejej Z Gd d ej Z e e fZed krddlZeje dSdS) a Editorial objects store comments and other metadata associated with specific :class:`~music21.base.Music21Object` elements such as Notes. Some aspects of :class:`~music21.editorial.Editorial` objects represent very early (pre-v0.1) versions of music21. Thus, some pre-defined aspects might be removed from documentation in the future. Access an editorial object by calling `.editorial` on any music21 object: >>> c = clef.TrebleClef() >>> ed = c.editorial >>> ed The object is lazily created on first access. To see if there is any existing editorial information without creating the object, call `.hasEditorialInformation` >>> n = note.Note('C#4') >>> n.hasEditorialInformation False >>> n.editorial.unedited = True >>> n.hasEditorialInformation True ) annotationsN)prebase)stylecNeZdZUdZddddddZded <d Zd Zd Zd Z dZ dZ dS) EditorialaI Editorial comments and special effects that can be applied to music21 objects. >>> ed1 = editorial.Editorial() >>> ed1.backgroundHighlight = 'yellow' # non-standard. >>> ed1.backgroundHighlight 'yellow' >>> list(ed1.keys()) ['backgroundHighlight'] >>> ed1 Every GeneralNote object already has a NoteEditorial object attached to it at object.editorial. Normally you will just change that object instead. For instance, take the case where a scribe wrote F in the score, knowing that a good singer would automatically sing F-sharp instead. We can store the editorial suggestion to sing F-sharp as a "musica ficta" accidental object: >>> fictaSharp = pitch.Accidental('sharp') >>> n = note.Note('F') >>> n.editorial.ficta = fictaSharp >>> assert(n.editorial.ficta.alter == 1.0) #_DOCS_HIDE >>> #_DOCS_SHOW n.show('lily.png') # only Lilypond currently supports musica ficta .. image:: images/noteEditorialFictaSharp.* :width: 103 z a list of :class:`~music21.editorial.Comment` objects that represent any comments about the object. z a list of :class:`~music21.editorial.Comment` objects that represent annotations for the object. These have specific meanings in MusicXML. za :class:`~music21.pitch.Accidental` object that specifies musica ficta for the note. Will only be displayed in LilyPond and then only if there is no Accidental object on the note itselfzan :class:`~music21.interval.Interval` object that specifies the harmonic interval between this object and a single other object, or None (useful for storing information post analysis)zan :class:`~music21.interval.Interval` object that specifies the melodic interval to the next object in this Part/Voice/Stream, etc.)comments footnotesfictaharmonicIntervalmelodicIntervalzdict[str, str] _DOC_ATTR)r r)r r r c6t|SN)dict__repr__selfs /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/editorial.py _reprInternalzEditorial._reprInternalds}}T"""c||vr||S||jvr g||<||S||jvr d||<||Std|)Nz%Editorial does not have an attribute )predefinedListspredefinedNonesAttributeErrorrnames r __getattr__zEditorial.__getattr__hsn 4<<:  T) ) )DJ:  T) ) )DJ:  !O!O!OPP Prc|||<dSr)rrvalues r __setattr__zEditorial.__setattr__tsT rc8||vr||=dStd|z)NzNo such attribute: )rrs r __delattr__zEditorial.__delattr__ws* 4<<T  !6!=>> >rN) __name__ __module__ __qualname____doc__r __annotations__rrrrr!r#rrrrr.s>@>W!!I(0OFO### Q Q Q?????rrc*eZdZdZdfd ZdZxZS)Commenta A comment or footnote or something else attached to a note. >>> c = editorial.Comment('presented as C natural in the 1660 print.') >>> c Note that the text is truncated in representation, but it is all there in `.text`: >>> c.text 'presented as C natural in the 1660 print.' >>> c.isFootnote = True >>> c.levelInformation = 'musicological' >>> n = note.Note('C#4') >>> n.editorial.footnotes.append(c) >>> n.editorial.footnotes[0] Comments have style information: >>> c.style.color = 'red' >>> c.style.color 'red' Nct||_d|_d|_d|_dS)NF)super__init__text isFootnote isReferencelevelInformation)rr. __class__s rr-zComment.__init__s=    $rc|jdSt|jdkrt|jSt|jdddzS)Nz...)r.lenreprrs rrzComment._reprInternalsM 9 2 ty>>B   ?? " #2#.// /rr)r$r%r&r'r-r __classcell__)r2s@rr*r*sV4%%%%%%0000000rr*ceZdZdZdS)TestcBddlm}||tdS)Nr) testCopyAll)music21.test.commonTestr=globals)rr=s rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys0777777 D'))$$$$$rN)r$r%r&r@rrrr;r;s#%%%%%rr;__main__)r' __future__runittestmusic21rrProtoM21Objectrr StyleMixinr*TestCaser; _DOC_ORDERr$mainTestrrrrJs06#"""""M?M?M?M?M?&M?M?M?b)0)0)0)0)0g$e&6)0)0)0\%%%%%8 %%%   zNNNGT r