#!/usr/bin/env python # (can be run with either Python 2 or Python 3) r""" # Jianpu (numbered musical notaion) for Lilypond # v1.77 (c) 2012-2024 Silas S. Brown # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # Homepage: http://ssb22.user.srcf.net/mwrhome/jianpu-ly.py # Git repository: https://github.com/ssb22/jianpu-ly # and on GitLab: https://gitlab.com/ssb22/jianpu-ly # and on Bitbucket: https://bitbucket.org/ssb22/jianpu-ly # and at https://gitlab.developers.cam.ac.uk/ssb22/jianpu-ly # and in China: https://gitee.com/ssb22/jianpu-ly # (The following docstring format is fixed, see --html) Run jianpu-ly < text-file > ly-file (or jianpu-ly text-files > ly-file) Text files are whitespace-separated and can contain: Scale going up: 1 2 3 4 5 6 7 1' Accidentals: 1 #1 2 b2 1 Octaves: 1,, 1, 1 1' 1'' Shortcuts for 1' and 2': 8 9 Change base octave: < > Semiquaver, quaver, crotchet (16/8/4th notes): s1 q1 1 Dotted versions of the above (50% longer): s1. q1. 1. Demisemiquaver, hemidemisemiquaver (32/64th notes): d1 h1 Minims (half notes) use dashes: 1 - Dotted minim: 1 - - Semibreve (whole note): 1 - - - Time signature: 4/4 Time signature with quaver anacrusis (8th-note pickup): 4/4,8 Key signature (major): 1=Bb Key signature (minor): 6=F# Tempo: 4=85 Lyrics: L: here are the syl- la- bles (all on one line) Lyrics (verse 1): L: 1. Here is verse one Lyrics (verse 2): L: 2. Here is verse two Hanzi lyrics (auto space): H: hanzi (with or without spaces) Lilypond headers: title=the title (on a line of its own) Guitar chords: chords=c2. g:7 c (on own line) Fret diagrams: frets=guitar (on own line) Multiple parts: NextPart Instrument of current part: instrument=Flute (on a line of its own) Multiple movements: NextScore Prohibit page breaks until end of this movement: OnePage Suppress bar numbers: NoBarNums Suppress first-line indent: NoIndent Ragged last line: RaggedLast Old-style time signature: SeparateTimesig 1=C 4/4 Indonesian 'not angka' style: angka Add a Western staff doubling the tune: WithStaff Tuplets: 3[ q1 q1 q1 ] Grace notes before: g[#45] 1 Grace notes after: 1 ['1]g Simple chords: 135 1 13 1 Da capo: 1 1 Fine 1 1 1 1 1 1 DC Repeat (with alternate endings): R{ 1 1 1 } A{ 2 | 3 } Short repeats (percent): R4{ 1 2 } Ties (like Lilypond's, if you don't want dashes): 1 ~ 1 Slurs (like Lilypond's): 1 ( 2 ) Erhu fingering (applies to previous note): Fr=0 Fr=4 Erhu symbol (applies to previous note): souyin harmonic up down bend tilde Tremolo: 1/// - 1///5 - Rehearsal letters: letterA letterB Multibar rest: R*8 Dynamics (applies to previous note): \p \mp \f Other 1-word Lilypond \ commands: \fermata \> \! \( \) etc Text: ^"above note" _"below note" Other Lilypond code: LP: (block of code) :LP (each delimeter at start of its line) Unicode approximation instead of Lilypond: Unicode Ignored: % a comment """ import sys,os,re,shutil from fractions import Fraction as F # requires Python 2.6+ if type(u"")==type(""): # Python 3 unichr,xrange = chr,range from string import ascii_letters as letters else: from string import letters # Python 2 def asUnicode(l): if type(l)==type(u""): return l return l.decode('utf-8') try: from commands import getoutput except: from subprocess import getoutput def lilypond_minor_version(): global _lilypond_minor_version try: return _lilypond_minor_version except: pass cmd = lilypond_command() if cmd: m=re.match(r".*ond-2\.([1-9][0-9])\.",cmd) if m: _lilypond_minor_version = int(m.group(1)) else: _lilypond_minor_version = int(getoutput(cmd+" --version").split()[2].split('.')[1]) else: _lilypond_minor_version = 20 # 2.20 return _lilypond_minor_version def lilypond_command(): if hasattr(shutil,'which'): w = shutil.which('lilypond') if w: return 'lilypond' elif not sys.platform.startswith("win"): cmd = getoutput('which lilypond 2>/dev/null') if os.path.exists(cmd): return 'lilypond' placesToTry = ['/Applications/LilyPond.app/Contents/Resources/bin/lilypond'] # e.g. from Mac OS 10.4-10.14 Intel build https://web.archive.org/web/20221121202056/https://lilypond.org/download/binaries/darwin-x86/lilypond-2.22.2-1.darwin-x86.tar.bz2 (unpacked and moved to /Applications), or similarly 2.20 for macOS 10.15+ from https://gitlab.com/marnen/lilypond-mac-builder/-/package_files/9872804/download placesToTry = ['/Applications/LilyPond-2.22.2.app/Contents/Resources/bin/lilypond','/Applications/LilyPond-2.20.0.app/Contents/Resources/bin/lilypond'] + placesToTry # if renamed from the above (try specific versions 1st, in case default is older) placesToTry += ['lilypond-2.24.0/bin/lilypond','/opt/lilypond-2.24.0/bin/lilypond'] # if unpacked 2.24 (which drops the .app; in macOS 13, might need first to manually open at least lilypond and gs binaries for Gatekeeper approval if installing it this way) for t in placesToTry: if os.path.exists(t): return t staff_size = float(os.environ.get("j2ly_staff_size",20)) # Normal: j2ly_staff_size=20 # Large: j2ly_staff_size=25.2 # Small: j2ly_staff_size=17.82 # Tiny: j2ly_staff_size=15.87 lyric_size = float(os.environ.get("j2ly_lyric_size",staff_size)) def all_scores_start(inDat): r = r"""\version "2.%d.0" #(set-global-staff-size %g)""" % ((20 if lilypond_minor_version()>=20 else 18),staff_size) r += r""" % un-comment the next line to remove Lilypond tagline: % \header { tagline="" } \pointAndClickOff \paper { print-all-headers = ##t %% allow per-score headers % un-comment the next line for A5: % #(set-default-paper-size "a5" ) % un-comment the next line for no page numbers: % print-page-number = ##f % un-comment the next 3 lines for a binding edge: % two-sided = ##t % inner-margin = 20\mm % outer-margin = 10\mm % un-comment the next line for a more space-saving header layout: % scoreTitleMarkup = \markup { \center-column { \fill-line { \magnify #1.5 { \bold { \fromproperty #'header:dedication } } \magnify #1.5 { \bold { \fromproperty #'header:title } } \fromproperty #'header:composer } \fill-line { \fromproperty #'header:instrument \fromproperty #'header:subtitle \smaller{\fromproperty #'header:subsubtitle } } } } """ if os.path.exists("/Library/Fonts/Arial Unicode.ttf") and lilypond_minor_version()>=20: r += r""" % As jianpu-ly was run on a Mac, we include a Mac fonts workaround. % The Mac version of Lilypond 2.18 used Arial Unicode MS as a % fallback even in the Serif font, but 2.20 drops this in Serif % (using it only in Sans), which means any Serif text (titles, % lyrics etc) that includes Chinese will likely fall back to % Japanese fonts which don't support all Simplified hanzi. % This brings back 2.18's behaviour on 2.20+: #(define fonts (set-global-fonts #:roman "Times New Roman,Arial Unicode MS" #:factor (/ staff-height pt 20) )) """ if has_lyrics: r += r""" % Might need to enforce a minimum spacing between systems, especially if lyrics are below the last staff in a system and numbers are on the top of the next system-system-spacing = #'((basic-distance . 7) (padding . 5) (stretchability . 1e7)) score-markup-spacing = #'((basic-distance . 9) (padding . 5) (stretchability . 1e7)) score-system-spacing = #'((basic-distance . 9) (padding . 5) (stretchability . 1e7)) markup-system-spacing = #'((basic-distance . 2) (padding . 2) (stretchability . 0)) """ r += "}\n" # end of \paper block return r+"\n%{ The jianpu-ly input was:\n" + inDat.strip().replace("%}","%/}")+"\n%}\n\n" def score_start(): ret = "\\score {\n" if midi: ret += "\\unfoldRepeats\n" ret += r"<< " if not notehead_markup.noBarNums and not midi: ret += ("\\override Score.BarNumber #'break-visibility = #center-visible\n\\override Score.BarNumber #'Y-offset = -1\n\\set Score.barNumberVisibility = #(every-nth-bar-number-visible %d)" % bar_number_every) return ret bar_number_every = 5 # TODO customise? (anyway don't leave it numbering at start of system, doesn't work well in jianpu+lyrics) def score_end(**headers): ret = ">>\n" if headers: # since about Lilypond 2.7, music must come # before the header block if it's per-score ret += r"\header{"+'\n' for k,v in headers.items(): ret+=k+'="'+v+'"\n' ret += "}\n" layoutExtra = "" if not lyric_size == staff_size: from math import log lSize = log(lyric_size/staff_size)*6/log(2) if lSize > 3: sys.stderr.write("WARNING: potential layout problems; consider increasing j2ly_staff_size to be closer to j2ly_lyric_size\n") # TODO: is 3 a good threshold for this warning? (need to check different Lilypond versions) layoutExtra=r" \override Lyrics.LyricText.font-size = #"+("+" if lSize>=0 else "")+str(lSize)+" " if notehead_markup.noIndent: layoutExtra += ' indent = 0.0 ' if notehead_markup.raggedLast: layoutExtra += ' ragged-last = ##t ' if notehead_markup.noBarNums: layoutExtra += r' \context { \Score \remove "Bar_number_engraver" } ' if midi: ret += r"\midi { \context { \Score tempoWholesPerMinute = #(ly:make-moment 84 4)}}" # will be overridden by any \tempo command used later else: ret += r"\layout{"+layoutExtra+"}" return ret + " }" def uniqName(): global uniqCount r = str(uniqCount) ; uniqCount += 1 return r.translate((letters*5)[:256]) def jianpu_voice_start(isTemp=0): if not isTemp and maxBeams >= 2: stemLenFrac = "0.5" # sometimes needed if the semiquavers occur in isolation rather than in groups (TODO do we need to increase this for 3+ beams in some cases?) else: stemLenFrac = "0" voiceName = uniqName() r = (r"""\new Voice="%s" {"""%voiceName) r += r""" \override Beam #'transparent = ##f""" if not_angka: r +=r""" \override Stem #'direction = #UP \override Tie #'staff-position = #-2.5 \tupletDown""" stemLenFrac=str(0.4+0.2*max(0,maxBeams-1)) else: r += r""" \override Stem #'direction = #DOWN \override Tie #'staff-position = #2.5 \tupletUp""" r += (r""" \override Stem #'length-fraction = #%s \override Beam #'beam-thickness = #0.1 \override Beam #'length-fraction = #0.5 \override Voice.Rest #'style = #'neomensural %% this size tends to line up better (we'll override the appearance anyway) \override Accidental #'font-size = #-4 \override TupletBracket #'bracket-visibility = ##t""" % stemLenFrac) r += "\n"+r"""\set Voice.chordChanges = ##t %% 2.19 bug workaround""" # LilyPond 2.19.82: \applyOutput docs say "called for every layout object found in the context Context at the current time step" but 2.19.x breaks this by calling it for ALL contexts in the current time step, hence breaking our WithStaff by applying our jianpu numbers to the 5-line staff too. Obvious workaround is to make our function check that the context it's called with matches our jianpu voice, but I'm not sure how to do this other than by setting a property that's not otherwise used, which we can test for in the function. So I'm 'commandeering' the "chordChanges" property (there since at least 2.15 and used by Lilypond only when it's in chord mode, which we don't use, and if someone adds a chord-mode staff then it won't print noteheads anyway): we will substitute jianpu numbers for noteheads only if chordChanges = #t. return r+"\n", voiceName def jianpu_staff_start(inst=None,withStaff=False): # (we add "BEGIN JIANPU STAFF" and "END JIANPU STAFF" comments to make it easier to copy/paste into other Lilypond files) if withStaff: inst = None # we'll put the label on the 5-line staff (TODO: use StaffGroup or something?) if not_angka: r=r""" %% === BEGIN NOT ANGKA STAFF === \new RhythmicStaff \with {""" else: r=r""" %% === BEGIN JIANPU STAFF === \new RhythmicStaff \with { \consists "Accidental_engraver" """ if inst: r += 'instrumentName = "'+inst+'"' if withStaff: r+=r""" %% Limit space between Jianpu and corresponding-Western staff \override VerticalAxisGroup.staff-staff-spacing = #'((minimum-distance . 7) (basic-distance . 7) (stretchability . 0)) """ # (whether this is needed or not depends on Lilypond version; 2.22 puts more space than 2.18,2.20. Must set higher than 5, which sometimes gets collisions between beams in 2.20) r+=r""" %% Get rid of the stave but not the barlines: \override StaffSymbol #'line-count = #0 %% tested in 2.15.40, 2.16.2, 2.18.0, 2.18.2, 2.20.0 and 2.22.2 \override BarLine #'bar-extent = #'(-2 . 2) %% LilyPond 2.18: please make barlines as high as the time signature even though we're on a RhythmicStaff (2.16 and 2.15 don't need this although its presence doesn't hurt; Issue 3685 seems to indicate they'll fix it post-2.18) } { """ j,voiceName = jianpu_voice_start() r += j+r""" \override Staff.TimeSignature #'style = #'numbered \override Staff.Stem #'transparent = ##t """ return r, voiceName def jianpu_staff_end(): # \bar "|." is added separately if there's not a DC etc if not_angka: return "} }\n% === END NOT ANGKA STAFF ===\n" else: return "} }\n% === END JIANPU STAFF ===\n" def midi_staff_start(): return r""" %% === BEGIN MIDI STAFF === \new Staff { \new Voice="%s" {""" % (uniqName(),) def midi_staff_end(): return "} }\n% === END MIDI STAFF ===\n" def western_staff_start(inst=None): r = r""" %% === BEGIN 5-LINE STAFF === \new Staff """ if inst: r += r'\with { instrumentName = "'+inst+'" } ' voiceName = uniqName() return (r+r"""{ \override Score.SystemStartBar.collapse-height = #11 %% (needed on 2.22) \new Voice="%s" { #(set-accidental-style 'modern-cautionary) \override Staff.TimeSignature #'style = #'numbered \set Voice.chordChanges = ##f %% for 2.19.82 bug workaround """ % (voiceName,)), voiceName def western_staff_end(): return "} }\n% === END 5-LINE STAFF ===\n" def lyrics_start(voiceName): return r'\new Lyrics = "I%s" { \lyricsto "%s" { ' % (uniqName(),voiceName) def lyrics_end(): return "} }" dashes_as_ties = True # Implement dash (-) continuations as invisible ties rather than rests; sometimes works better in awkward beaming situations use_rest_hack = True # Implement some short rests as notes (and if there are lyrics, creates temporary voices so the lyrics miss them); sometimes works better for beaming (at least in 2.15 through 2.24) if __name__=="__main__" and '--noRestHack' in sys.argv: # TODO: document use_rest_hack=False ; sys.argv.remove('--noRestHack') assert not (use_rest_hack and not dashes_as_ties), "This combination has not been tested" def errExit(msg): if __name__=="__main__": sys.stderr.write("Error: "+msg+"\n") sys.exit(1) else: raise Exception(msg) def scoreError(msg,word,line): if len(word)>60: word=word[:50]+"..." msg += " %s in score %d" % (word,scoreNo) if len(line)>600: line=line[:500]+"..." if not word in line: pass # above truncations caused problems elif "xterm" in os.environ.get("TERM",""): # use xterm underline escapes msg += "\n"+re.sub(r"(\s|^)"+re.escape(word)+r"(?=\s|$)",lambda m:m.group(1)+"\x1b[4m"+word+"\x1b[m",line) elif re.match('[ -~]*$',line): # all ASCII: we can underline the word with ^^s msg += "\n"+line+"\n"+re.sub('[^^]',' ',re.sub(r"(\s|^)"+re.escape(word)+r"(?=\s|$)",lambda m:m.group(1)+'^'*(len(word)),line)) else: # don't try to underline the word (at least not without ANSI): don't know how the terminal will handle character widths msg += "\nin this line: "+line errExit(msg) placeholders = { # for accidentals and word-fitting to work # (we make them relative to the actual key later # so that MIDI pitches are correct) '0':'r', '1':'c', '2':'d', '3':'e', '4':'f', '5':'g', '6':'a', '7':'b', '-':'r'} def addOctaves(octave1,octave2): octave2=octave2.replace(">","'").replace("<",",") # so it can be used with a base-octave change while octave1: if octave1[0] in "'>": # go up if ',' in octave2: octave2 = octave2[:-1] else: octave2 += "'" else: # , or < : go down if "'" in octave2: octave2 = octave2[:-1] else: octave2 += "," octave1=octave1[1:] return octave2 class NoteheadMarkup: def __init__(self): self.defines_done = {} ; self.initOneScore() def initOneScore(self): self.barLength = 64 ; self.beatLength = 16 # in 64th notes self.barPos = self.startBarPos = F(0) self.inBeamGroup = self.lastNBeams = self.onePage = self.noBarNums = self.noIndent = self.raggedLast = self.separateTimesig = self.withStaff = 0 self.keepLength = 0 self.last_octave = self.base_octave = "" self.current_accidentals = {} self.barNo = 1 self.tuplet = (1,1) self.last_figures = None self.last_was_rest = False self.notesHad = [] self.unicode_approx = [] self.rplacNextIfStillInBeam = None def endScore(self): if self.barPos == self.startBarPos: pass elif os.environ.get("j2ly_sloppy_bars",""): sys.stderr.write("Wrong bar length at end of score %d ignored (j2ly_sloppy_bars set)\n" % scoreNo) elif self.startBarPos and not self.barPos: errExit("Score %d should end with a %g-beat bar to make up for the %g-beat anacrusis bar. Set j2ly_sloppy_bars environment variable if you really want to break this rule." % (scoreNo,self.startBarPos/self.beatLength,(self.barLength-self.startBarPos)/self.beatLength)) # this is on the music theory syllabi at about Grade 3, but you can get up to Grade 5 practical without actually covering it, so we'd better not expect all users to understand "final bar does not make up for anacrusis bar" else: errExit("Incomplete bar at end of score %d (%g beats)" % (scoreNo,self.barPos*1.0/self.beatLength)) def setTime(self,num,denom): self.barLength = int(64*num/denom) if denom>4 and num%3==0: self.beatLength = 24 # compound time else: self.beatLength = 16 def setAnac(self,denom,dotted): self.barPos = F(self.barLength)-F(64)/denom if dotted: self.barPos -= F(64)/denom/2 if self.barPos<0: errExit("Anacrusis is longer than bar in score %d" % scoreNo) # but anacrusis being exactly equal to bar is OK: we'll just interpret that as no anacrusis self.startBarPos = self.barPos def wholeBarRestLen(self): return {96:"1.",48:"2.",32:"2",24:"4.",16:"4",12:"8.",8:"8"}.get(self.barLength,"1") # TODO: what if irregular? def baseOctaveChange(self,change): self.base_octave = addOctaves(change,self.base_octave) def __call__(self,figures,nBeams,dots,octave,accidental,tremolo,word,line): # figures is a chord string of '1'-'7', or '0' or '-' # nBeams is 0, 1, 2 .. etc (number of beams for this note) # dots is "" or "." or ".." etc (extra length) # octave is "", "'", "''", "," or ",," # accidental is "", "#", "b" # tremolo is "" or ":32" # word,line is for error handling if len(figures)>1: if accidental: scoreError("Accidentals in chords not yet implemented:",word,line) # see TODOs below if '0' in figures: scoreError("Can't have rest in chord:",word,line) self.notesHad.append(figures) names = {'0':'nought', '1':'one', '2':'two', '3':'three', '4':'four', '5':'five', '6':'six', '7':'seven', '-':'dash'} def get_placeholder_chord(figures): if len(figures)==1: return placeholders[figures] elif not midi and not western: return 'c' # we'll override its appearance else: return "< "+" ".join(placeholders[f] for f in list(figures))+" >" placeholder_chord = get_placeholder_chord(figures) invisTieLast = dashes_as_ties and self.last_figures and figures=="-" and not self.last_was_rest self.last_was_rest = (figures=='0' or (figures=='-' and self.last_was_rest)) name = ''.join(names[f] for f in figures) if not_angka: # include accidental in the lookup key # because it affects the notehead shape figures += accidental # TODO: chords? name += {"#":"-sharp","b":"-flat","":""}[accidental] aftrLastNonDash = tieEnd = "" if invisTieLast: # (so figures == "-") if self.barPos==0 and not midi and not western and lilypond_minor_version()>=20: # dash over barline: write as new note figures = self.last_figures name = ''.join(names[f] for f in figures) aftrLastNonDash = r'\=JianpuTie(' tieEnd = r'\=JianpuTie)' else: figures += self.last_figures # (so "-" + last) name += ''.join(names[f] for f in self.last_figures) if self.barPos==0 and not midi and not western: sys.stderr.write("Warning: jianpu barline-crossing tie won't be done right because your Lilypond version is older than 2.20\n") placeholder_chord = get_placeholder_chord(self.last_figures) octave = self.last_octave # for MIDI or 5-line accidental = self.last_accidental # ditto else: octave=addOctaves(octave,self.base_octave) if not octave in [",,",",","","'","''"]: scoreError("Can't handle octave "+octave+" in",word,line) self.last_octave = octave self.last_figures = figures if len(self.last_figures)>1 and self.last_figures[0]=='-': self.last_figures = self.last_figures[1:] if not accidental in ["","#","b"]: scoreError("Can't handle accidental "+accidental+" in",word,line) self.last_accidental = accidental if figures not in self.defines_done and not midi and not western: # Define a notehead graphical object for the figures self.defines_done[figures] = "note-"+name if figures.startswith("-"): if not_angka: figuresNew="." else: figuresNew=u"\u2013" if not type(u"")==type(""): figuresNew=figuresNew.encode('utf-8') else: figuresNew = figures ret = """#(define (%s grob grob-origin context) (if (and (eq? (ly:context-property context 'chordChanges) #t) (or (grob::has-interface grob 'note-head-interface) (grob::has-interface grob 'rest-interface))) (begin (ly:grob-set-property! grob 'stencil (grob-interpret-markup grob """ % self.defines_done[figures] if len(figuresNew)==1 or figures.startswith("-"): ret += """(make-lower-markup 0.5 (make-bold-markup "%s"))))))) """ % figuresNew elif not_angka and accidental: # not chord u338,u20e5=u"\u0338",u"\u20e5" # TODO: the \ looks better than the / in default font if not type("")==type(u""): u338,u20e5=u338.encode('utf-8'),u20e5.encode('utf-8') ret += '(make-lower-markup 0.5 (make-bold-markup "%s%s")))))))\n' % (figures[:1],{'#':u338,'b':u20e5}[accidental]) else: ret += """(markup (#:lower 0.5 (#:override (cons (quote direction) 1) (#:override (cons (quote baseline-skip) 1.8) (#:dir-column (\n""" + "".join(' #:line (#:bold "'+f+'")\n' for f in figuresNew) + """))))))))))) """ # TODO: can do accidentals e.g. #:halign 1 #:line ((#:fontsize -5 (#:raise 0.7 (#:flat))) (#:bold "3")) but might cause the beam not to extend its full length if this chord occurs at the end of a beamed group, + accidentals won't be tracked by Lilypond and would have be taken care of by jianpu-ly (which might mean if any chord has an accidental on one of its notes we'd have to do all notes in that bar like this, whether they are chords or not) else: ret = "" if self.barPos==0 and self.barNo > 1: ret += "| " # barline in Lilypond file: not strictly necessary but may help readability if self.onePage and not midi: ret += r"\noPageBreak " ret += "%{ bar "+str(self.barNo)+": %} " if not octave in self.current_accidentals: self.current_accidentals[octave] = [""]*7 if nBeams==None: # unspecified if self.keepLength: nBeams = self.lastNBeams else: nBeams = 0 if figures=="-" or all('1'<=figure<='7' and not accidental==self.current_accidentals[octave][int(figure)-1] for figure in list(figures)) and nBeams > self.lastNBeams: leftBeams = nBeams # beam needs to fit under the new accidental (or the dash which might be slightly to the left of where digits are), but if it's no more than last note's beams then we'll hang it only if in same beat. (TODO: the current_accidentals logic may need revising if other accidental styles are used, e.g. modern-cautionary, although then would need to check anyway if our \consists "Accidental_engraver" is sufficient) # TODO: if figures=="0" then that might be typeset a bit to the left as well (because it's also a rest), however extending the line TOO far left in this case could be counterproductive elif self.inBeamGroup: if nBeams < self.lastNBeams: leftBeams = nBeams else: leftBeams = self.lastNBeams else: leftBeams = 0 if leftBeams: assert nBeams, "following logic assumes if (leftBeams or nBeams) == if nBeams" aftrlast0 = "" if not nBeams and self.inBeamGroup: if not self.inBeamGroup=="restHack": aftrlast0 = "] " self.inBeamGroup = 0 length = 4 ; b = 0 ; toAdd = F(16) # crotchet while b < nBeams: b,length,toAdd = b+1,length*2,toAdd/2 toAdd0 = toAdd for _ in dots: toAdd0 /= 2 ; toAdd += toAdd0 toAdd_preTuplet = toAdd if not self.tuplet[0]==self.tuplet[1]: toAdd = toAdd*self.tuplet[0]/self.tuplet[1] if nBeams and not midi and not western: # must set these unconditionally regardless of what we think their current values are (Lilypond's own beamer can change them from note to note) if not_angka: leftBeams=nBeams if (self.barPos+toAdd)%self.beatLength == 0: nBeams = 0 ret += (r"\set stemLeftBeamCount = #%d"+"\n") % leftBeams ret += (r"\set stemRightBeamCount = #%d"+"\n") % nBeams if not_angka: nBeams = leftBeams need_space_for_accidental = False for figure in list(figures): if '1'<=figure<='7': if not accidental==self.current_accidentals[octave][int(figure)-1]: need_space_for_accidental = True self.current_accidentals[octave][int(figure)-1] = accidental # TODO: not sensible (assumes accidental applies to EVERY note in the chord, see above) inRestHack = replaceLast = 0 if not midi and not western: if ret: ret = ret.rstrip()+"\n" # try to keep the .ly code vaguely readable if octave=="''" and not invisTieLast: ret += r" \once \override Score.TextScript.outside-staff-priority = 45" # inside bar numbers etc ret += r" \applyOutput #'Voice #"+self.defines_done[figures]+" " if self.rplacNextIfStillInBeam and leftBeams and nBeams: replaceLast = self.rplacNextIfStillInBeam # didn't need the rest-hack here after all self.rplacNextIfStillInBeam = None if placeholder_chord == "r" and use_rest_hack and nBeams and not (leftBeams and not not_angka): placeholder_chord = "c" # C to work around diagonal-tail problem with # some isolated quaver rests in some Lilypond # versions (usually at end of bar); new voice # so lyrics miss it as if it were a rest: if has_lyrics and not self.withStaff: # (OK if self.withStaff: lyrics will be attached to that instead) self.rplacNextIfStillInBeam = ret ret = jianpu_voice_start(1)[0]+ret inRestHack = 1 if self.inBeamGroup and not self.inBeamGroup=="restHack": aftrlast0 = "] " if placeholder_chord.startswith("<"): # Octave with chords: apply to last note if up, 1st note if down notes = placeholder_chord.split()[1:-1] assert len(notes) >= 2 notes[0] += {",":"",",,":","}.get(octave,"'") for n in range(1,len(notes)-1): notes[n] += "'" notes[-1] += {"'":"''","''":"'''"}.get(octave,"'") ret += "< "+" ".join(notes)+" >" else: # single note or rest ret += placeholder_chord + {"":"", "#":"is", "b":"es"}[accidental] if not placeholder_chord=="r": ret += {"":"'","'":"''","''":"'''",",":"",",,":","}[octave] # for MIDI + Western, put it so no-mark starts near middle C ret += ("%d" % length) + dots if self.rplacNextIfStillInBeam: self.rplacNextIfStillInBeam += ("r%d" % length) + dots + '[' if tremolo: if lilypond_minor_version()<20: errExit("tremolo requires Lilypond 2.20+, we found 2."+str(lilypond_minor_version())) if midi or western: if placeholder_chord.startswith("<") and len(placeholder_chord.split())==4: previous,n1,n2,gtLenDot = ret.rsplit(None,3) previous=previous[:-1] # drop < ret = r"%s\repeat tremolo %d { %s32 %s32 }" % (previous,int(toAdd_preTuplet/4),n1,n2) else: ret += tremolo elif lilypond_minor_version()>=22: if dots: ret += r"""_\tweak outside-staff-priority ##f ^\tweak avoid-slur #'inside _\markup {\with-dimensions #'(0 . 0) #'(2.8 . 2.1) \postscript "1.6 -0.2 moveto 2.6 0.8 lineto 1.8 -0.4 moveto 2.8 0.6 lineto 2.0 -0.6 moveto 3.0 0.4 lineto stroke" } %{ requires Lilypond 2.22+ %} """ else: ret += r"""_\tweak outside-staff-priority ##f ^\tweak avoid-slur #'inside _\markup {\with-dimensions #'(0 . 0) #'(2.5 . 2.1) \postscript "1.1 0.4 moveto 2.1 1.4 lineto 1.3 0.2 moveto 2.3 1.2 lineto 1.5 0.0 moveto 2.5 1.0 lineto stroke" } %{ requires Lilypond 2.22+ %} """ elif dots: ret += r"""_\tweak outside-staff-priority ##f ^\tweak avoid-slur #'inside _\markup {\with-dimensions #'(0 . 0) #'(2.8 . 2.6) \postscript "1.4 1.6 moveto 2.4 2.6 lineto 1.6 1.4 moveto 2.6 2.4 lineto 1.8 1.2 moveto 2.8 2.2 lineto stroke" } %{ requires Lilypond 2.20 %} """ else: ret += r"""_\tweak outside-staff-priority ##f ^\tweak avoid-slur #'inside _\markup {\with-dimensions #'(0 . 0) #'(2.5 . 2.6) \postscript "1.1 1.6 moveto 2.1 2.6 lineto 1.3 1.4 moveto 2.3 2.4 lineto 1.5 1.2 moveto 2.5 2.2 lineto stroke" } %{ requires Lilypond 2.20 %} """ if nBeams and (not self.inBeamGroup or (self.inBeamGroup=="restHack" and not replaceLast) or inRestHack) and not midi and not western: # We need the above stemLeftBeamCount, stemRightBeamCount override logic to work even if we're an isolated quaver, so do this: ret += '[' self.inBeamGroup = 1 self.barPos += toAdd # sys.stderr.write(accidental+figure+octave+dots+"/"+str(nBeams)+"->"+str(self.barPos)+" ") # if need to see where we are if self.barPos > self.barLength: errExit("(notesHad=%s) barcheck fail: note crosses barline at \"%s\" with %d beams (%d skipped from %d to %d, bypassing %d), scoreNo=%d barNo=%d (but the error could be earlier)" % (' '.join(self.notesHad),figures,nBeams,toAdd,self.barPos-toAdd,self.barPos,self.barLength,scoreNo,self.barNo)) if self.barPos%self.beatLength == 0 and self.inBeamGroup: # (self.inBeamGroup is set only if not midi/western) # jianpu printouts tend to restart beams every beat # (but if there are no beams running anyway, it occasionally helps typesetting to keep the logical group running, e.g. to work around bugs involving beaming a dash-and-rest beat in 6/8) (TODO: what if there's a dash-and-rest BAR? [..]-notated beams don't usually work across barlines ret += ']' self.inBeamGroup = 0 # DON'T reset lastNBeams here (needed for start-of-group accidental logic) elif inRestHack and self.inBeamGroup: ret += ']' self.inBeamGroup = "restHack" self.lastNBeams = nBeams beamC = u'\u0333' if nBeams>=2 else u'\u0332' if nBeams==1 else u"" self.unicode_approx.append(u""+(u"-" if invisTieLast else figures[-1:])+(u"" if invisTieLast else (u'\u0323' if "," in octave else u'\u0307' if "'" in octave else u""))+beamC+u''.join(c+beamC for c in dots)+(u"" if self.inBeamGroup else u" ")) # (NB inBeamGroup is correct only if not midi and not western) if self.barPos == self.barLength: self.unicode_approx[-1]=self.unicode_approx[-1].rstrip()+u'\u2502' self.barPos = 0 ; self.barNo += 1 self.current_accidentals = {} # Octave dots: if not midi and not western and not invisTieLast: # Tweak the Y-offset, as Lilypond occasionally puts it too far down: if not nBeams: ret += {",":r"-\tweak #'Y-offset #-1.2 ", ",,":r"-\tweak #'Y-offset #1 "}.get(octave,"") oDict = {"":"", "'":"^.", "''":r"-\tweak #'X-offset #0.3 ^\markup{\bold :}", ",":r"-\tweak #'X-offset #0.6 _.", ",,":r"-\tweak #'X-offset #0.3 _\markup{\bold :}"} if not_angka: oDict.update({ "'":r"-\tweak #'extra-offset #'(0.4 . 2.7) -\markup{\bold .}", "''":r"-\tweak #'extra-offset #'(0.4 . 3.5) -\markup{\bold :}", }) ret += oDict[octave] if invisTieLast: if midi or western: b4last, aftrlast = "", " ~" else: b4last,aftrlast = r"\once \override Tie #'transparent = ##t \once \override Tie #'staff-position = #0 "," ~" else: b4last,aftrlast = "","" if inRestHack: ret += " } " # end temporary voice for the "-" (non)-note elif tieEnd: ret += ' '+tieEnd # end of JianpuTie curve return aftrLastNonDash,figures.startswith('-'),b4last,replaceLast,aftrlast0+aftrlast,ret, need_space_for_accidental, nBeams,octave def parseNote(word,origWord,line): if word==".": word = "-" # (for not angka, TODO: document that this is now acceptable as an input word?) word = word.replace("8","1'").replace("9","2'") if type(u"")==type(""): word = word.replace(u"\u2019","'") else: word=word.replace(u"\u2019".encode('utf-8'),"'") if "///" in word: tremolo,word=":32",word.replace("///","",1) else: tremolo = "" if not re.match(r"[0-7.,'cqsdh\\#b-]+$",word): # unrecognised stuff in it: flag as error, rather than ignoring and possibly getting a puzzling barsync fail scoreError("Unrecognised command",origWord,line) figures = ''.join(re.findall('[01234567-]',word)) dots = "".join(c for c in word if c==".") nBeams = ''.join(re.findall(r'[cqsdh\\]',word)) if re.match(r"[\\]+$",nBeams): nBeams=len(nBeams) # requested by a user who found British note-length names hard to remember; won't work if the \ is placed at the start, as that'll be a Lilypond command, so to save confusion we won't put this in the docstring elif nBeams: try: nBeams = list("cqsdh").index(nBeams) except ValueError: scoreError("Can't calculate number of beams from "+nBeams+" in",origWord,line) else: nBeams=None # unspecified octaves = re.findall("'+|,+",word) if len(octaves)>1: scoreError("Multiple octave-dot settings not yet implemented:",origWord,line) # TODO: apparently, multiple sets of octave dots in chords are stacked, so a dot ends up vertically between figures; this would require adding to defines_done name and the dir-column, probably with baseline-skip adjustments if octaves: octave = octaves[0] else: octave = "" accidental = "".join(c for c in word if c in "#b") return figures,nBeams,dots,octave,accidental,tremolo def write_docs(): # Write an HTML or Markdown version of the doc string def htmlify(l): if "--html" in sys.argv: return l.replace("&","&").replace("<","<").replace(">",">") else: return l inTable = 0 ; justStarted=1 for line in __doc__.split("\n"): if line.startswith("#") or not line.strip(): continue if ":" in line and line.split(":",1)[1].strip(): toGet,shouldType = line.split(":",1) if not inTable: if "--html" in sys.argv: print ("
To get: | Type: |
---|---|
"+htmlify(toGet.strip())+" | "+htmlify(shouldType.strip())+""+htmlify(note)+" | ") else: print (toGet.strip()+": `"+shouldType.strip()+"`"+note+"\n") else: if "--markdown" in sys.argv: print ("") elif inTable: print ("