3j dZddlmZddlZddlmZddlmZGddejeZ Gdd ejejZ Gd d ejZ e e fZed k(rddlZej e yy) 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)stylecLeZdZUdZddddddZded <d Zd Zd Zd Z dZ dZ y) 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 c,tj|SN)dict__repr__selfs >/DATA/.local/lib/python3.12/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__hsh 4<:  T)) )DJ:  T)) )DJ:  #H!OP Prc|||<yr)rrvalues r __setattr__zEditorial.__setattr__ts T rc.||vr||=ytd|z)NzNo such attribute: )rrs r __delattr__zEditorial.__delattr__ws! 4<T  !6!=> >rN) __name__ __module__ __qualname____doc__r __annotations__rrrrr!r#rrrrr.sQ>@>W!I~(0OFO# 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' cZt|||_d|_d|_d|_y)NF)super__init__text isFootnote isReferencelevelInformation)rr. __class__s rr-zComment.__init__s,    $rc|jyt|jdkrt|jSt|jdddzS)Nz...)r.lenreprrs rrzComment._reprInternalsG 99  tyy>B  ? " #2./ /rr)r$r%r&r'r-r __classcell__)r2s@rr*r*s4%0rr*ceZdZdZy)Testc2ddlm}||ty)Nr) testCopyAll)music21.test.commonTestr=globals)rr=s rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys7D')$rN)r$r%r&r@rrrr;r;s%rr;__main__)r' __future__runittestmusic21rrProtoM21Objectrr StyleMixinr*TestCaser; _DOC_ORDERr$mainTestrrrrJs6#M?&&M?b)0g$$e&6&6)0\%8  %   zGT r