3jdZddlmZddlZddlmZddlmZddlmZGdde ejZ Gd d ejeZ Gd d ejZed k(rddlZej"eyy)z The `tie` module contains a single class, `Tie` that represents the visual and conceptual idea of tied notes. They can be start or stop ties. ) annotationsN) exceptions21)SlottedObjectMixin)prebasec eZdZy) TieExceptionN)__name__ __module__ __qualname__8/DATA/.local/lib/python3.12/site-packages/music21/tie.pyrrsr rcJeZdZUdZdZddddZded<d Zdd Zd Z d Z d Z y)Tiea An object added to Notes that are tied to other notes. The `type` value is one of start, stop, or continue. >>> note1 = note.Note() >>> note1.tie = tie.Tie('start') # start, stop, or continue >>> note1.tie.style = 'normal' # default; could also be 'dotted' or 'dashed' or 'hidden' >>> note1.tie.type 'start' >>> note1.tie Generally Ties have a placement of None, but if they are defined as 'above' or 'below' this will be retained. (see: `this discussion`_ for how orientation and placement in musicxml are essentially the same content). .. _this discussion: https://web.archive.org/web/20210302051136/https://forums.makemusic.com/viewtopic.php?f=12&t=2179&start=0 >>> note1.tie.placement is None True Differences from MusicXML: * notes do not need to know if they are tied from a previous note. i.e., you can tie n1 to n2 just with a tie start on n1. However, if you want proper musicXML output you need a tie stop on n2. * one tie with "continue" implies tied from and tied to. The tie.style only applies to Tie objects of type 'start' or 'continue' (and then only to the next part of the tie). For instance, if there are two tied notes, and the first note has a 'dotted'-start tie, and the second note has a 'dashed'-stop tie, the graphical tie itself will be dotted. A type of tie that is unknown raises a ValueError: >>> tie.Tie('hello') Traceback (most recent call last): music21.tie.TieException: Type must be one of ('start', 'stop', 'continue', 'let-ring', 'continue-let-ring'), not hello OMIT_FROM_DOCS optional (to know what notes are next): .to = note() # not implemented yet, b/c of garbage coll. .from = note() (question: should notes be able to be tied to multiple notes for the case where a single note is tied both voices of a two-note-head unison?) )id placementstyletypezo The tie type, can be 'start', 'stop', 'continue', 'let-ring', or 'continue-let-ring'. zj The style of the tie. Currently can be 'normal', 'dotted', 'dashed' or 'hidden' z Whether the tie should go up or down. Can be None, meaning it is unknown or should be determined from context, or 'above' or 'below. )rrrzdict[str, str] _DOC_ATTR)startstopcontinuezlet-ringzcontinue-let-ringc||jvrtd|jd|t||_||_d|_d|_y)NzType must be one of z, not normal)VALID_TIE_TYPESrrrrr)selfrs r__init__z Tie.__init__lsX t++ +&t';';&>> t1 = tie.Tie('start') >>> t2 = tie.Tie('start') >>> t3 = tie.Tie('stop') >>> t1 == t2 True >>> t2 == t3, t3 == t1 (False, False) >>> t2 == None False FT) isinstancer)rothers r__eq__z Tie.__eq__zs+"%d, YY%** $r ct|dz S)N)rrs r__hash__z Tie.__hash__s$x1}r c|jS)N)rr$s r _reprInternalzTie._reprInternals yyr N)r) r r r __doc__ __slots__r__annotations__rrr!r%r'r r rrrsH4lI !I~ UO .r rceZdZdZy)Testc2ddlm}||ty)Nr) testCopyAll)music21.test.commonTestr.globals)rr.s rtestCopyAndDeepcopyzTest.testCopyAndDeepcopys7D')$r N)r r r r1r r rr,r,s%r r,__main__)r( __future__runittestmusic21rmusic21.common.objectsrr ValueErrorMusic21ExceptionrProtoM21ObjectrTestCaser,r mainTestr r rr<s{# 5 :|<< x' "4xt%8  % zGTr