rh SrSSKJr SSKrSSKJr SSKJr "SS\R\5r "SS \R\R5r "S S \R5r \ \ 4r\S :XaSSKr\R "\ 5 gg) 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)stylecT\rSrSr%SrSSSSSS.rS \S 'S rS rS r Sr Sr Sr Sr g) Editorial/a 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,[RU5$N)dict__repr__selfs K/home/james-whalen/.local/lib/python3.13/site-packages/music21/editorial.py _reprInternalEditorial._reprInternales}}T""cX;aX$XR;a/X'X$XR;aSX'X$[SU35e)Nz%Editorial does not have an attribute )predefinedListspredefinedNonesAttributeErrorrnames r __getattr__Editorial.__getattr__isX <:  )) )DJ:  )) )DJ:  #H!OP Prc X U'gr)rrvalues r __setattr__Editorial.__setattr__us T rc.X;aX g[SU-5e)NzNo such attribute: )rrs r __delattr__Editorial.__delattr__xs <  !6!=> >rr"N)__name__ __module__ __qualname____firstlineno____doc__r__annotations__rrrrr$r'__static_attributes__r"rrrr/sQ>@>W!I~(0OFO# Q?rrc6^\rSrSrSrSU4SjjrSrSrU=r$)Commentao 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' cX>[TU]5 XlSUlSUlSUlg)NF)super__init__text isFootnote isReferencelevelInformation)rr6 __class__s rr5Comment.__init__s*    $rcURcg[UR5S:a[UR5$[URSSS-5$)Nz...)r6lenreprrs rrComment._reprInternalsG 99  tyy>B  ? " #2./ /r)r7r8r9r6r) r)r*r+r,r-r5rr/ __classcell__)r:s@rr1r1s4%00rr1c\rSrSrSrSrg)Testc2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestrHglobals)rrHs rtestCopyAndDeepcopyTest.testCopyAndDeepcopys7D')$rr"N)r)r*r+r,rKr/r"rrrErEs%rrE__main__)r- __future__runittestmusic21rrProtoM21Objectrr StyleMixinr1TestCaserE _DOC_ORDERr)mainTestr"rrrVs6#M?&&M?b)0g$$e&6&6)0\%8  %   z T r