diff options
author | Karl Berry <karl@freefriends.org> | 2018-03-13 22:07:05 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-03-13 22:07:05 +0000 |
commit | b5f3209624cdaeceec32d0878fc3bfa5b3585670 (patch) | |
tree | c5c457a935ea3bbda4e98d9a80ab3bbc6366af82 /Master/texmf-dist/scripts | |
parent | 60225bd10db8028303b99b5992eb3c9d60e89763 (diff) |
lyluatex (13mar18)
git-svn-id: svn://tug.org/texlive/trunk@46952 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/scripts')
-rwxr-xr-x | Master/texmf-dist/scripts/lyluatex/lyluatex.lua | 1498 |
1 files changed, 1371 insertions, 127 deletions
diff --git a/Master/texmf-dist/scripts/lyluatex/lyluatex.lua b/Master/texmf-dist/scripts/lyluatex/lyluatex.lua index bf9b29579d4..fd54cd22c87 100755 --- a/Master/texmf-dist/scripts/lyluatex/lyluatex.lua +++ b/Master/texmf-dist/scripts/lyluatex/lyluatex.lua @@ -1,195 +1,1439 @@ +-- luacheck: ignore ly log self luatexbase internalversion font fonts tex token kpse status local err, warn, info, log = luatexbase.provides_module({ name = "lyluatex", - version = '0', - greinternalversion = internalversion, - date = "2017/12/05", + version = '1.0b', --LYLUATEX_VERSION + date = "2018/03/12", --LYLUATEX_DATE description = "Module lyluatex.", - author = "The Gregorio Project − Jacques Peron <cataclop@hotmail.com>", - copyright = "2008-2017 - The Gregorio Project", + author = "The Gregorio Project − (see Contributors.md)", + copyright = "2015-2018 - jperon and others", license = "MIT", }) local md5 = require 'md5' +local lfs = require 'lfs' +local latex = {} +local ly = {} +local obj = {} +local Score = {} -LILYPOND = 'lilypond' -TMP = 'tmp_ly' -N = 0 +local FILELIST +local OPTIONS = {} +local DIM_OPTIONS = { + 'extra-bottom-margin', + 'extra-top-margin', + 'gutter', + 'hpadding', + 'indent', + 'leftgutter', + 'line-width', + 'max-protrusion', + 'max-left-protrusion', + 'max-right-protrusion', + 'rightgutter', + 'paperwidth', + 'paperheight', + 'voffset' +} +local HASHIGNORE = { + 'autoindent', + 'cleantmp', + 'hpadding', + 'max-left-protrusion', + 'max-right-protrusion', + 'print-only', + 'valign', + 'voffset' +} +local MXML_OPTIONS = { + 'absolute', + 'language', + 'lxml', + 'no-articulation-directions', + 'no-beaming', + 'no-page-layout', + 'no-rest-positions', + 'verbose', +} +local TEXINFO_OPTIONS = {'doctitle', 'nogettext', 'texidoc'} +local TEX_UNITS = {'bp', 'cc', 'cm', 'dd', 'in', 'mm', 'pc', 'pt', 'sp', 'em', 'ex'} +local LY_HEAD = [[ +%%File header +\version "<<<version>>>" +<<<language>>> + +<<<preamble>>> + +#(define inside-lyluatex #t) +#(set-global-staff-size <<<staffsize>>>) + +\header { + copyright = "" + tagline = ##f +} +\paper{ + <<<paper>>> + two-sided = ##<<<twoside>>> + line-width = <<<linewidth>>>\pt + <<<indent>>> + <<<raggedright>>> + <<<fonts>>> +} +\layout{ + <<<staffprops>>> +} + +%%Follows original score +]] -function ly_definir_programme(lilypond) - if lilypond then LILYPOND = lilypond end +--[[ ========================== Helper functions ========================== ]] +-- dirty fix as info doesn't work as expected +local oldinfo = info +function info(...) + print('\n(lyluatex)', string.format(...)) + oldinfo(...) +end +-- debug acts as info if [debug] is specified +local function debug(...) + if Score.debug then info(...) end end -function contenuIntegral(contenu) - local content ="" - for i, Line in ipairs(contenu:explode('\n')) do - if Line:find("^%s*[^%%]*\\include") then - local i = io.open(Line:gsub('%s*\\include%s*"(.*)"%s*$', "%1"), 'r') - if i then - content = content .. contenuIntegral(i:read('*a')) - else - content = content .. Line .. "\n" - end - else - content = content .. Line .. "\n" - end +local function contains(table_var, value) + for _, v in pairs(table_var) do + if v == value then return true + elseif v == 'false' and value == false then return true + end end - return content end -function direct_ly(ly, largeur, facteur) - N = N + 1 - largeur = {['n'] = largeur:match('%d+'), ['u'] = largeur:match('%a+')} - facteur = calcul_facteur(facteur) - ly = ly:gsub('\\par ', '\n'):gsub('\\([^%s]*) %-([^%s])', '\\%1-%2') - local sortie = - TMP..'/'..string.gsub(md5.sumhexa(contenuIntegral(ly))..'-'..facteur..'-'..largeur.n..largeur.u, '%.', '-') - if not lfs.isfile(sortie..'-systems.tex') then - compiler_ly(entete_lilypond(facteur, largeur)..'\n'..ly, sortie, true) +local function contains_key(table_var, key) + for k in pairs(table_var) do + if k == key then return true end end - retour_tex(sortie, facteur) end -function inclure_ly(entree, currfiledir, largeur, facteur, pleinepage) - largeur = {['n'] = largeur:match('%d+'), ['u'] = largeur:match('%a+')} - facteur = calcul_facteur(facteur) - nom = splitext(entree, 'ly') - entree = currfiledir..nom..'.ly' - if not lfs.isfile(entree) then entree = kpse.find_file(nom..'.ly') end - if not lfs.isfile(entree) then err("Le fichier %s.ly n'existe pas.", nom) end - local i = io.open(entree, 'r') - ly = i:read('*a') - i:close() - local sortie = TMP..'/'..string.gsub(md5.sumhexa(contenuIntegral(ly))..'-'..facteur..'-'..largeur.n..largeur.u..'-', '%.', '-') - if pleinepage then sortie = sortie..'-pleinepage' end - if not lfs.isfile(sortie..'-systems.tex') then - if pleinepage then - compiler_ly(ly, sortie, false, dirname(entree)) - i = io.open(sortie..'-systems.tex', 'w') - i:write('\\includepdf[pages=-]{'..sortie..'}') - i:close() +local function convert_unit(value) + if not value then return 0 + elseif value == '' then return false + elseif value:match('\\') then + local n, u = value:match('^%d*%.?%d*'), value:match('%a+') + if n == '' then n = 1 end + return tonumber(n) * tex.dimen[u] / tex.sp("1pt") + else return ('%f'):format(tonumber(value) or tex.sp(value) / tex.sp("1pt")) + end +end + + +local function dirname(str) return str:gsub("(.*/)(.*)", "%1") or '' end + + +local function extract_includepaths(includepaths) + includepaths = includepaths:explode(',') + local cfd = Score.currfiledir:gsub('^$', './') + table.insert(includepaths, 1, cfd) + for i, path in ipairs(includepaths) do + -- delete initial space (in case someone puts a space after the comma) + includepaths[i] = path:gsub('^ ', ''):gsub('^~', os.getenv("HOME")) + end + return includepaths +end + + +local fontdata = fonts.hashes.identifiers +local function fontinfo(id) return fontdata[id] or font.fonts[id] end + + +local function font_default_staffsize() + return fontinfo(font.current()).size/39321.6 +end + + +local function locate(file, includepaths, ext) + local result + for _, d in ipairs(extract_includepaths(includepaths)) do + if d:sub(-1) ~= '/' then d = d..'/' end + result = d..file + if lfs.isfile(result) then break end + end + if not lfs.isfile(result) and ext and file:match('%.[^%.]+$') ~= ext then return locate(file..ext, includepaths) end + if not lfs.isfile(result) then result = kpse.find_file(file) end + return result +end + + +local function max(a, b) + a, b = tonumber(a), tonumber(b) + if a > b then return a else return b end +end + + +local function min(a, b) + a, b = tonumber(a), tonumber(b) + if a < b then return a else return b end +end + + +local function mkdirs(str) + local path = '.' + for dir in str:gmatch('([^%/]+)') do + path = path .. '/' .. dir + lfs.mkdir(path) + end +end + + +local function orderedpairs(t) + local key + local i = 0 + local orderedIndex = {} + for k in pairs(t) do table.insert(orderedIndex, k) end + table.sort(orderedIndex) + return function () + i = i + 1 + key = orderedIndex[i] + if key then return key, t[key] end + end +end + + +local function process_options(k, v) + if k == '' or k == 'noarg' then return end + if not contains_key(OPTIONS, k) then err('Unknown option: '..k) end + -- aliases + if OPTIONS[k] and OPTIONS[k][2] == ly.is_alias then + if OPTIONS[k][1] == v then return + else k = OPTIONS[k][1] + end + end + -- boolean + if v == 'false' then v = false end + -- negation (for example, noindent is the negation of indent) + if ly.is_neg(k) then + if v ~= nil and v ~= 'default' then + k = k:gsub('^no(.*)', '%1') + v = not v + else return + end + end + return k, v +end + + +local function range_parse(range, nsystems) + local num = tonumber(range) + if num then return {num} end + -- if nsystems is set, we have insert=systems + if nsystems ~= 0 and range:sub(-1) == '-' then range = range..nsystems end + if not range:match('^%d+%s*-%s*%d*$') then + warn([[ +Invalid value '%s' for item +in list of page ranges. Possible entries: +- Single number +- Range (M-N, N-M or N-) +This item will be skipped! +]], + range + ) + return + end + local result = {} + local from, to = tonumber(range:match('^%d+')), tonumber(range:match('%d+$')) + if to then + local dir + if from <= to then dir = 1 else dir = -1 end + for i = from, to, dir do table.insert(result, i) end + return result + else return {range} -- N- with insert=fullpage + end +end + + +local function readlinematching(s, f) + if f then + local result = '' + while result and not result:find(s) do result = f:read() end + f:close() + return result + end +end + + +local function set_lyscore(score) + ly.score = score + ly.score.nsystems = ly.score:count_systems() + if score.insert ~= 'fullpage' then -- systems and inline + local hoffset = ly.score.protrusion or 0 + if hoffset == '' then hoffset = 0 end + ly.score.hoffset = hoffset..'pt' + for s = 1, ly.score.nsystems do + table.insert(ly.score, ly.score.output..'-'..s) + end + else ly.score[1] = ly.score.output + end +end + + +local function splitext(str, ext) return str:match('(.*)%.'..ext..'$') or str end + + +--[[ ================ Bounding box calculations =========================== ]] + +local bbox = {} +function bbox.get(filename, line_width) + return bbox.read(filename) or bbox.parse(filename, line_width) +end + +function bbox.parse(filename, line_width) + -- get BoundingBox from EPS file + local bbline = readlinematching('^%%%%BoundingBox', io.open(filename..'.eps', 'r')) + if not bbline then return end + local x_1, y_1, x_2, y_2 = bbline:match('(%--%d+)%s(%--%d+)%s(%--%d+)%s(%--%d+)') + -- try to get HiResBoundingBox from PDF (if 'gs' works) + bbline = readlinematching( + '^%%%%HiResBoundingBox', + io.popen('gs -sDEVICE=bbox -q -dBATCH -dNOPAUSE '..filename..'.pdf 2>&1', 'r') + ) + if bbline then + local pbb = bbline:gmatch('(%d+%.%d+)') + -- The HiRes BoundingBox retrieved from the PDF differs from the + -- BoundingBox present in the EPS file. In the PDF (0|0) is the + -- Lower Left corner while in the EPS (0|0) represents the top + -- edge at the start of the staff symbol. + -- Therefore we shift the HiRes results by the (truncated) + -- points of the EPS bounding box. + x_1, y_1, x_2, y_2 = pbb() + x_1, pbb() + y_1, pbb() + x_1, pbb() + y_1 + else warn([[gs couldn't be launched; there could be rounding errors.]]) + end + local bb = { + ['protrusion'] = -convert_unit(("%fbp"):format(x_1)), + ['r_protrusion'] = convert_unit(("%fbp"):format(x_2)) - line_width, + ['width'] = convert_unit(("%fbp"):format(x_2)), + ['height'] = convert_unit(("%fbp"):format(y_2)) - convert_unit(("%fbp"):format(y_1)) + } + obj.serialize(bb, filename..'.bbox') + return bb +end + +function bbox.read(f) return obj.deserialize(f..'.bbox') end + + +--[[ =============== Functions that output LaTeX code ===================== ]] + +function latex.filename(printfilename, insert, input_file) + if printfilename and input_file then + if insert ~= 'systems' then + warn('`printfilename` only works with `insert=systems`') else - compiler_ly(entete_lilypond(facteur, largeur)..'\n'..ly, sortie, true, dirname(entree)) + local filename = input_file:gsub("(.*/)(.*)", "\\lyFilename{%2}\\par") + tex.sprint(filename) + end + end +end + +function latex.fullpagestyle(style, ppn) + local function texoutput(s) tex.sprint('\\includepdfset{pagecommand='..s..'}%') end + if style == '' then + if ppn then texoutput('\\thispagestyle{empty}') + else texoutput('') end + else texoutput('\\thispagestyle{'..style..'}') end - retour_tex(sortie, facteur) end +function latex.includeinline(pdfname, height, valign, hpadding, voffset) + local v_base + if valign == 'bottom' then v_base = 0 + elseif valign == 'top' then v_base = convert_unit('1em') - height + else v_base = (convert_unit('1em') - height) / 2 + end + tex.sprint( + string.format( + [[\hspace{%fpt}\raisebox{%fpt}{\includegraphics{%s-1.pdf}}\hspace{%fpt}]], + hpadding, v_base + voffset, pdfname, hpadding + ) + ) +end -function compiler_ly(ly, sortie, eps, include) - mkdirs(dirname(sortie)) - local commande = LILYPOND.." ".. - "-dno-point-and-click ".. - "-djob-count=2 ".. - "-ddelete-intermediate-files " - if eps then commande = commande.."-dbackend=eps " end - if include then commande = commande.."-I '"..lfs.currentdir().."/"..include.."' " end - commande = commande.."-o "..sortie.." -" - local p = io.popen(commande, 'w') - p:write(ly) - p:close() +function latex.includepdf(pdfname, range, papersize) + local noautoscale = '' + if papersize then noautoscale = 'noautoscale' end + tex.sprint(string.format( + [[\includepdf[pages={%s},%s]{%s}]], + table.concat(range, ','), noautoscale, pdfname + )) +end + +function latex.includesystems(filename, range, protrusion, gutter, staffsize, indent_offset) + local h_offset = protrusion + indent_offset + local texoutput = '\\ifx\\preLilyPondExample\\undefined\\else\\preLilyPondExample\\fi\n' + texoutput = texoutput..'\\par\n' + for index, system in pairs(range) do + if not lfs.isfile(filename..'-'..system..'.pdf') then break end + texoutput = texoutput.. + string.format([[ +\noindent\hspace*{%fpt}\includegraphics{%s}%% +]], + h_offset + gutter, filename..'-'..system + ) + if index < #range then + texoutput = texoutput.. + string.format([[ +\ifx\betweenLilyPondSystem\undefined\par\vspace{%fpt plus %fpt minus %fpt}%% +\else\betweenLilyPondSystem{%s}\fi%% +]], + staffsize / 4, staffsize / 12, staffsize / 16, + index + ) + end + end + texoutput = texoutput..'\n\\ifx\\postLilyPondExample\\undefined\\else\\postLilyPondExample\\fi' + tex.sprint(texoutput:explode('\n')) end +function latex.label(label, labelprefix) + if label then tex.sprint('\\label{'..labelprefix..label..'}%%') end +end -function entete_lilypond(facteur, largeur) - return string.format( -[[%%En-tête -\version "2.18.2" -#(define default-toplevel-book-handler - print-book-with-defaults-as-systems ) -#(define toplevel-book-handler - (lambda ( . rest) - (set! output-empty-score-list #f) - (apply print-book-with-defaults rest))) +ly.verbenv = {[[\begin{verbatim}]], [[\end{verbatim}]]} +function latex.verbatim(verbatim, ly_code, intertext, version) + if verbatim then + if version then tex.sprint('\\lyVersion{'..version..'}') end + local content = table.concat(ly_code:explode('\n'), '\n'):gsub( + '.*%%%s*begin verbatim', ''):gsub( + '%%%s*end verbatim.*', '') + --[[ We unfortunately need an external file, + as verbatim environments are quite special. ]] + local fname = ly.get_option('tmpdir')..'/verb.tex' + local f = io.open(fname, 'w') + f:write( + ly.verbenv[1]..'\n'.. + content.. + '\n'..ly.verbenv[2]:gsub([[\end {]], [[\end{]])..'\n' + ) + f:close() + tex.sprint('\\input{'..fname..'}') + if intertext then tex.sprint('\\lyIntertext{'..intertext..'}') end + end +end -#(define toplevel-music-handler - (lambda ( . rest) - (apply collect-music-for-book rest))) -#(define toplevel-score-handler - (lambda ( . rest) - (apply collect-scores-for-book rest))) +--[[ =============== Functions that operate on objects ==================== ]] -#(define toplevel-text-handler - (lambda ( . rest) - (apply collect-scores-for-book rest))) +function obj.deserialize(f) if lfs.isfile(f) then return dofile(f) end end +function obj.serialize(o, f) + f = io.open(f, 'w') + if not f then return end + f:write('local o = '..obj.str(o)..'\nreturn o') + f:close() +end -#(set-global-staff-size %s) +function obj.str(o) + if type(o) == "number" then return o + elseif type(o) == "string" then return string.format("%q", o) + elseif type(o) == "table" then + local r = '{\n' + for k, v in pairs(o) do r = r.." ["..obj.str(k).."] = "..obj.str(v)..",\n" end + return r.."}\n" + else error("cannot convert " .. type(o).." to string") + end +end -%%Paramètres de la partition -\paper{ - indent = 0\mm - line-width = %s\%s -} +--[[ =============================== Classes =============================== ]] + +-- Score class +function Score:new(ly_code, options, input_file) + local o = options or {} + setmetatable(o, self) + self.__index = self + o.output_names = {} + o.input_file = input_file + o.ly_code = ly_code + return o +end + +function Score:bbox(system) + if system then + if not self.bboxes then + self.bboxes = {} + for i = 1, self:count_systems() do + table.insert(self.bboxes, bbox.get(self.output..'-'..i, self['line-width'])) + end + end + return self.bboxes[system] + else + if not self.bbox then self.bbox = bbox.get(self.output, self['line-width']) end + return self.bbox + end +end + +function Score:calc_properties() + self:calc_staff_properties() + -- fragment and relative + if self.relative and not self.fragment then + -- local option takes precedence over global option + if Score.fragment then self.relative = false end + end + if self.relative then + self.fragment = 'true' -- yes, here we need a string, not a bool + if self.relative == '' then self.relative = 1 + else self.relative = tonumber(self.relative) + end + end + if self.fragment == '' then + -- by default, included files shouldn't be fragments + if ly.state == 'file' then self.fragment = false end + end + -- default insertion mode + if self.insert == '' then + if ly.state == 'cmd' then self.insert = 'inline' + else self.insert = 'systems' + end + end + -- staffsize + self.staffsize = tonumber(self.staffsize) + if self.staffsize == 0 then self.staffsize = font_default_staffsize() end + if self.insert == 'inline' or self.insert == 'bare-inline' then + local inline_staffsize = tonumber(self['inline-staffsize']) + if inline_staffsize == 0 then inline_staffsize = self.staffsize / 1.5 end + self.staffsize = inline_staffsize + end + -- dimensions that can be given by LaTeX + for _, dimension in pairs(DIM_OPTIONS) do + self[dimension] = convert_unit(self[dimension]) + end + self['max-left-protrusion'] = self['max-left-protrusion'] or self['max-protrusion'] + self['max-right-protrusion'] = self['max-right-protrusion'] or self['max-protrusion'] + if self.quote then + self.leftgutter = self.leftgutter or self.gutter + self.rightgutter = self.rightgutter or self.gutter + self['line-width'] = self['line-width'] - self.leftgutter - self.rightgutter + else + self.leftgutter = 0 + self.rightgutter = 0 + end + -- store for comparing protrusion against + self.original_lw = self['line-width'] + self.original_indent = self.indent + -- explicit indent disables autoindent + if self.indent then self.autoindent = false end + -- score fonts + if self['current-font-as-main'] then self.rmfamily = self['current-font'] end + -- LilyPond version + if self.addversion then self.addversion = self:lilypond_version(true) end + -- temporary file name + self.output = self:output_filename() +end + +function Score:calc_range() + local nsystems = self:count_systems(true) + if self['print-only'] == '' then + if nsystems == 0 then self['print-only'] = '1-' + else self['print-only'] = '1-'..nsystems + end + end + local result = {} + if tonumber(self['print-only']) then result = {self['print-only']} + else + for _, r in pairs(self['print-only']:explode(',')) do + local range = range_parse(r:gsub('^%s', ''):gsub('%s$', ''), nsystems) + if range then + for _, v in pairs(range) do table.insert(result, v) end + end + end + end + return result +end + +function Score:calc_staff_properties() + -- preset for bare notation symbols in inline images + if self.insert == 'bare-inline' then self.nostaff = 'true' end + -- handle meta properties + if self.notime then + self.notimesig = 'true' + self.notiming = 'true' + end + if self.nostaff then + self.nostaffsymbol = 'true' + self.notimesig = 'true' + -- do *not* suppress timing + self.noclef = 'true' + end +end + +function Score:check_compilation() + local debug_msg, doc_debug_msg + if self.debug then + debug_msg = string.format([[ +Please check the log file +and the generated LilyPond code in +%s +%s +]], + self.output..'.log', self.output..'.ly' + ) + doc_debug_msg = [[ +A log file and a LilyPond file have been written.\\ +See log for details.]] + else + debug_msg = [[ +If you need more information +than the above message, +please retry with option debug=true. +]] + doc_debug_msg = "Re-run with \\texttt{debug} option to investigate." + end + if self.fragment then + local frag_msg = '\n'..[[ +As the input code has been automatically wrapped +with a music expression, you may try repeating +with the `nofragment` option.]] + debug_msg = debug_msg..frag_msg + doc_debug_msg = doc_debug_msg..frag_msg + end + + if self:is_compiled() then + if self.lilypond_error then + warn([[ -%%Partition originale +LilyPond reported a failed compilation but +produced a score. %s ]], -facteur, -largeur.n, largeur.u -) + debug_msg + ) + end + -- we do have *a* score (although labeled as failed by LilyPond) + return true + else + self:clean_failed_compilation() + if self.showfailed then + tex.sprint(string.format([[ +\begin{quote} +\minibox[frame]{LilyPond failed to compile a score.\\ +%s} +\end{quote} + +]], + doc_debug_msg + )) + warn([[ + +LilyPond failed to compile the score. +%s +]], + debug_msg + ) + else + err([[ + +LilyPond failed to compile the score. +%s +]], + debug_msg + ) + end + -- We don't have any compiled score + return false + end end +function Score:check_indent(lp) + local nsystems = self:count_systems() -function calcul_facteur(facteur) - if facteur == 0 then facteur = fontinfo(font.current()).size/39321.6 end - return facteur + local function handle_autoindent() + self.indent_offset = 0 + if lp.shorten > 0 then + if not self.indent or self.indent == 0 then + self.indent = lp.overflow_left + lp.shorten = max(lp.shorten - lp.overflow_left, 0) + else + self.indent = max(self.indent - lp.overflow_left, 0) + end + lp.changed_indent = true + end + end + + local function handle_indent() + if not self.indent_offset then + -- First step: deactivate indent + self.indent_offset = 0 + if self:count_systems() > 1 then + -- only recompile if the *original* score has more than 1 system + self.indent = 0 + lp.changed_indent = true + end + info('Deactivate indentation because of system selection') + elseif lp.shorten > 0 then + self.indent = 0 + self.autoindent = true + -- lp.changed_indent = true + handle_autoindent() + info('Deactivated indent causes protrusion.') + end + end + + local function regular_score() + -- score without any indent or with the first system + -- printed regularly, with others following. + return not self.original_indent or + nsystems > 1 and #self.range > 1 and self.range[1] == 1 + end + + local function simple_noindent() + -- score with indent and only one system + return self.original_indent and nsystems == 1 + end + + if simple_noindent() then + self.indent_offset = -self.indent + warn('Deactivate indent for single-system score.') + elseif self.autoindent then handle_autoindent() + elseif regular_score() then self.indent_offset = 0 + else handle_indent() + end end +function Score:check_properties() + local unexpected = false + for k, _ in orderedpairs(OPTIONS) do + if self[k] == 'default' then + self[k] = OPTIONS[k][1] or nil + unexpected = not self[k] + end + if not contains(OPTIONS[k], self[k]) and OPTIONS[k][2] then + if type(OPTIONS[k][2]) == 'function' then OPTIONS[k][2](k, self[k]) + else unexpected = true + end + end + if unexpected then + err([[ +Unexpected value "%s" for option %s: +authorized values are "%s" +]], + self[k], k, table.concat(OPTIONS[k], ', ') + ) + end + end + for _, k in pairs(TEXINFO_OPTIONS) do + if self[k] then info([[Option %s is specific to Texinfo: ignoring it.]], k) end + end + if self.fragment then + if (self.input_file or + self.ly_code:find([[\book]]) or + self.ly_code:find([[\header]]) or + self.ly_code:find([[\layout]]) or + self.ly_code:find([[\paper]]) or + self.ly_code:find([[\score]]) + ) then + warn([[ +Found something incompatible with `fragment` +(or `relative`). Setting them to false. +]] + ) + self.fragment = false + self.relative = false + end + end +end -function retour_tex(sortie, facteur) - local i = io.open(sortie..'-systems.tex', 'r') - local contenu = i:read("*all") - i:close() - local texoutput, nbre = contenu:gsub([[\includegraphics{]], - [[\includegraphics{]]..dirname(sortie)) - tex.print(([[\noindent]]..texoutput):explode('\n')) +function Score:check_protrusion(bbox_func) + self.range = self:calc_range() + if self.insert ~= 'systems' then return self:is_compiled() end + local bb = bbox_func(self.output, self['line-width']) + if not bb then return end + -- line_props lp + local lp = {} + -- Determine offset due to left protrusion + lp.overflow_left = max(bb.protrusion - math.floor(self['max-left-protrusion']), 0) + self.protrusion_left = lp.overflow_left - bb.protrusion + -- Determine further line properties + lp.stave_extent = lp.overflow_left + min(self['line-width'], bb.width) + lp.available = self.original_lw + self['max-right-protrusion'] + lp.total_extent = lp.stave_extent + bb.r_protrusion + -- Check if stafflines protrude into the right margin after offsetting + -- Note: we can't *reliably* determine this with ragged one-system scores, + -- possibly resulting in unnecessarily short lines when right protrusion is + -- present + lp.stave_overflow_right = max(lp.stave_extent - self.original_lw, 0) + -- Check if image as a whole protrudes over max-right-protrusion + lp.overflow_right = max(lp.total_extent - lp.available, 0) + lp.shorten = max(lp.stave_overflow_right, lp.overflow_right) + lp.changed_indent = false + self:check_indent(lp, bb) + if lp.shorten > 0 or lp.changed_indent then + self['line-width'] = self['line-width'] - lp.shorten + -- recalculate hash to reflect the reduced line-width + if lp.shorten > 0 then + info('Compiled score exceeds protrusion limit(s)') + end + if lp.changed_indent then info([[Adjusted indent.]]) end + self.output = self:output_filename() + warn('Recompile or reuse cached score') + return + else return true + end +end + +function Score:clean_failed_compilation() + for file in lfs.dir(self.tmpdir) do + local filename = self.tmpdir..'/'..file + if filename:find(self.output) then os.remove(filename) end + end +end + +function Score:content() + local n = '' + if self.relative then + self.fragment = 'true' -- in case it would serve later + if self.relative < 0 then + for _ = -1, self.relative, -1 do n = n..',' end + elseif self.relative > 0 then + for _ = 1, self.relative do n = n.."'" end + end + return string.format([[\relative c%s {%s}]], n, self.ly_code) + elseif self.fragment then return [[{]]..self.ly_code..[[}]] + else return self.ly_code + end +end + +function Score:count_systems(force) + if force or not self.system_count then + local f = io.open(self.output..'-systems.count', 'r') + if f then + self.system_count = tonumber(f:read('*all')) + f:close() + else self.system_count = 0 + end + end + return self.system_count +end + +function Score:delete_intermediate_files() + for _, filename in pairs(self.output_names) do + if self.insert == 'fullpage' then os.remove(filename..'.ps') + else + for i = 1, self:count_systems() do os.remove(filename..'-'..i..'.eps') end + os.remove(filename..'-systems.tex') + os.remove(filename..'-systems.texi') + os.remove(filename..'.eps') + os.remove(filename..'.pdf') + end + end +end + +function Score:flatten_content(ly_code) + --[[ Produce a flattend string from the original content, + including referenced files (if they can be opened. + Other files (from LilyPond's include path) are considered + irrelevant for the purpose of a hashsum.) --]] + local f + local includepaths = self.includepaths + if self.input_file then includepaths = self.includepaths..','..dirname(self.input_file) end + for iline in ly_code:gmatch('\\include%s*"[^"]*"') do + f = io.open(locate(iline:match('\\include%s*"([^"]*)"'), includepaths, '.ly') or '') + if f then + ly_code = ly_code:gsub(iline, self:flatten_content(f:read('*a'))) + f:close() + end + end + return ly_code +end + +function Score:header() + local header = LY_HEAD + for element in LY_HEAD:gmatch('<<<(%w+)>>>') do + header = header:gsub('<<<'..element..'>>>', self['ly_'..element](self) or '') + end + return header +end + +function Score:is_compiled() + return lfs.isfile(self.output..'.pdf') or self:count_systems(true) ~= 0 end +function Score:is_odd_page() return tex.count['c@page'] % 2 == 1 end + +function Score:lilypond_cmd(ly_code) + local input, mode = '-s -', 'w' + if self.debug then + local f = io.open(self.output..'.ly', 'w') + f:write(ly_code) + f:close() + input = self.output..".ly 2>&1" + mode = 'r' + end + local cmd = self.program.." ".. + "-dno-point-and-click ".. + "-djob-count=2 ".. + "-dno-delete-intermediate-files " + if self.input_file then + cmd = cmd..'-I "'..dirname(self.input_file):gsub('%./', lfs.currentdir()..'/')..'" ' + end + for _, dir in ipairs(extract_includepaths(self.includepaths)) do + cmd = cmd..'-I "'..dir:gsub('^%./', lfs.currentdir()..'/')..'" ' + end + cmd = cmd..'-o "'..self.output..'" '..input + debug("Command:\n"..cmd) + return cmd, mode +end -function dirname(str) - if str:match(".-/.-") then - local name = string.gsub(str, "(.*/)(.*)", "%1") - return name +function Score:lilypond_version(number) + local result = readlinematching('GNU LilyPond', io.popen(self.program..' --version', 'r')) + if result then + if number then return result:match('%d+%.%d+%.?%d*') + else + info( + "Compiling score %s with LilyPond executable '%s'.", + self.output, self.program + ) + debug(result) + end else - return '' + err([[ +LilyPond could not be started. +Please check that LuaLaTeX is started with the +--shell-escape option, and that 'program' +points to a valid LilyPond executable. +]] + ) end end +function Score:ly_fonts() + if self['pass-fonts'] then + return string.format([[ +#(define fonts + (make-pango-font-tree "%s" + "%s" + "%s" + (/ staff-height pt 20))) +]], + self.rmfamily, + self.sffamily, + self.ttfamily + ) + end +end + +function Score:ly_indent() + if not (self.indent == false and self.insert == 'fullpage') then + return [[indent = ]]..(self.indent or 0)..[[\pt]] + end +end + +function Score:ly_language() + if self.language then return '\\language "'..self.language..'"' end +end + +function Score:ly_linewidth() return self['line-width'] end + +function Score:ly_staffsize() return self.staffsize end -function splitext(str, ext) - if str:match(".-%..-") then - local name = string.gsub(str, "(.*)(%." .. ext .. ")", "%1") - return name +function Score:ly_margins() + local tex_top = self['extra-top-margin'] + self:tex_margin_top() + local tex_bottom = self['extra-bottom-margin'] + self:tex_margin_bottom() + if self.fullpagealign == 'crop' then + return string.format([[ +top-margin = %s\pt +bottom-margin = %s\pt +inner-margin = %s\pt +left-margin = %s\pt +]], + tex_top, tex_bottom, self:tex_margin_inner(), self:tex_margin_left() + ) + elseif self.fullpagealign == 'staffline' then + local top_distance = 4 * tex_top / self.staffsize + 2 + local bottom_distance = 4 * tex_bottom / self.staffsize + 2 + return string.format([[ +top-margin = 0\pt +bottom-margin = 0\pt +inner-margin = %s\pt +left-margin = %s\pt +top-system-spacing = + #'((basic-distance . %s) + (minimum-distance . %s) + (padding . 0) + (stretchability . 0)) +top-markup-spacing = + #'((basic-distance . %s) + (minimum-distance . %s) + (padding . 0) + (stretchability . 0)) +last-bottom-spacing = + #'((basic-distance . %s) + (minimum-distance . %s) + (padding . 0) + (stretchability . 0)) +]], + self:tex_margin_inner(), + self:tex_margin_left(), + top_distance, + top_distance, + top_distance, + top_distance, + bottom_distance, + bottom_distance + ) else - return str + err([[ +Invalid argument for option 'fullpagealign'. +Allowed: 'crop', 'staffline'. +Given: %s +]], + self.fullpagealign + ) end end +function Score:ly_paper() + local papersize = '#(set-paper-size "'..(self.papersize or 'lyluatexfmt')..'")' + if self.insert == 'fullpage' then + local ppn = 'f' + if self['print-page-number'] then ppn = 't' end + return string.format([[ +%s +print-page-number = ##%s +print-first-page-number = ##t +first-page-number = %s +%s]], + papersize, ppn, tex.count['c@page'], self:ly_margins() + ) + elseif self.papersize then return papersize + end +end -function mkdirs(str) - path = '.' - for dir in string.gmatch(str, '([^%/]+)') do - path = path .. '/' .. dir - lfs.mkdir(path) +function Score:ly_preamble() + if self.insert == 'fullpage' then + return string.format( + [[#(set! paper-alist (cons '("lyluatexfmt" . (cons (* %s pt) (* %s pt))) paper-alist))]], + self.paperwidth, self.paperheight + ) + else return [[\include "lilypond-book-preamble.ly"]] + end +end + +function Score:ly_raggedright() + if not self['ragged-right'] == 'default' then + if self['ragged-right'] then return 'ragged-right = ##t' + else return 'ragged-right = ##f' + end end end +function Score:ly_staffprops() + local clef, timing, timesig, staff = '', '', '', '' + if self.noclef then clef = [[\context { \Staff \remove "Clef_engraver" }]] end + if self.notiming then timing = [[\context { \Score timing = ##f }]] end + if self.notimesig then timesig = [[\context { \Staff \remove "Time_signature_engraver" }]] end + if self.nostaffsymbol then staff = [[\context { \Staff \remove "Staff_symbol_engraver" }]] end + return string.format('%s\n%s\n%s\n%s', clef, timing, timesig, staff) +end + +function Score:ly_twoside() if self.twoside then return 't' else return 'f' end end -local fontdata = fonts.hashes.identifiers -function fontinfo(id) - local f = fontdata[id] - if f then - return f +function Score:ly_version() return self['ly-version'] end + +function Score:optimize_pdf() + if not self['optimize-pdf'] then return end + local pdf2ps, ps2pdf, path + for file in lfs.dir(self.tmpdir) do + path = self.tmpdir..'/'..file + if path:match(self.output) and path:sub(-4) == '.pdf' then + pdf2ps = io.popen( + 'gs -q -sDEVICE=ps2write -sOutputFile=- -dNOPAUSE '..path..' -c quit', + 'r' + ) + ps2pdf = io.popen( + 'gs -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite -sOutputFile='..path..'-gs -', + 'w' + ) + if pdf2ps then + ps2pdf:write(pdf2ps:read('*a')) + pdf2ps:close() + ps2pdf:close() + os.rename(path..'-gs', path) + else + warn( + [[You have asked for pdf optimization, but gs wasn't found.]] + ) + end + end + end +end + +function Score:output_filename() + local properties = '' + for k, _ in orderedpairs(OPTIONS) do + if (not contains(HASHIGNORE, k)) and self[k] and type(self[k]) ~= 'function' then + properties = properties..'\n'..k..'\t'..self[k] + end + end + if self.insert == 'fullpage' then + properties = properties.. + self:tex_margin_top()..self:tex_margin_bottom().. + self:tex_margin_left()..self:tex_margin_right() + end + local filename = md5.sumhexa(self:flatten_content(self.ly_code)..properties) + return self.tmpdir..'/'..filename +end + +function Score:process() + self:check_properties() + self:calc_properties() + -- with bbox.read check_ptrotrusion will only execute with + -- a prior compilation, otherwise it will be ignored + local do_compile = not self:check_protrusion(bbox.read) + if do_compile then + repeat + self:run_lilypond(self:header()..self:content()) + if self:is_compiled() then table.insert(self.output_names, self.output) + else + self:clean_failed_compilation() + break + end + until self:check_protrusion(bbox.get) + self:optimize_pdf() + else table.insert(self.output_names, self.output) + end + set_lyscore(self) + if not self['raw-pdf'] then self:write_latex(do_compile) end + self:write_to_filelist() + if not self.debug then self:delete_intermediate_files() end +end + +function Score:run_lilypond(ly_code) + if self:is_compiled() then return end + mkdirs(dirname(self.output)) + self:lilypond_version() + local p = io.popen(self:lilypond_cmd(ly_code)) + if self.debug then + local f = io.open(self.output..".log", 'w') + f:write(p:read('*a')) + f:close() + else p:write(ly_code) + end + self.lilypond_error = not p:close() +end + +function Score:tex_margin_bottom() + self._tex_margin_bottom = self._tex_margin_bottom or + convert_unit(tex.dimen.paperheight..'sp') + - self:tex_margin_top() + - convert_unit(tex.dimen.textheight..'sp') + return self._tex_margin_bottom +end + +function Score:tex_margin_inner() + self._tex_margin_inner = self._tex_margin_inner or + convert_unit(( + tex.sp('1in') + tex.dimen.oddsidemargin + tex.dimen.hoffset + )..'sp') + return self._tex_margin_inner +end + +function Score:tex_margin_outer() + self._tex_margin_outer = self._tex_margin_outer or + convert_unit((tex.dimen.paperwidth - tex.dimen.textwidth)..'sp') + - self:tex_margin_inner() + return self._tex_margin_outer +end + +function Score:tex_margin_left() + if self:is_odd_page() then return self:tex_margin_inner() + else return self:tex_margin_outer() + end +end + +function Score:tex_margin_right() + if self:is_odd_page() then return self:tex_margin_outer() + else return self:tex_margin_inner() + end +end + +function Score:tex_margin_top() + self._tex_margin_top = self._tex_margin_top or + convert_unit(( + tex.sp('1in') + tex.dimen.voffset + tex.dimen.topmargin + + tex.dimen.headheight + tex.dimen.headsep + )..'sp') + return self._tex_margin_top +end + +function Score:write_latex(do_compile) + latex.filename(self.printfilename, self.insert, self.input_file) + latex.verbatim(self.verbatim, self.ly_code, self.intertext, self.addversion) + if do_compile and not self:check_compilation() then return end + --[[ Now we know there is a proper score --]] + latex.fullpagestyle(self.fullpagestyle, self['print-page-number']) + latex.label(self.label, self.labelprefix) + if self.insert == 'fullpage' then + latex.includepdf(self.output, self.range, self.papersize) + elseif self.insert == 'systems' then + latex.includesystems( + self.output, self.range, self.protrusion_left, + self.leftgutter, self.staffsize, self.indent_offset + ) + else -- inline + if self:count_systems() > 1 then + warn([[ +Score with more than one system included inline. +This will probably cause bad output.]] + ) + end + latex.includeinline( + self.output, self:bbox(1).height, self.valign, self.hpadding, self.voffset + ) + end +end + +function Score:write_to_filelist() + local f = io.open(FILELIST, 'a') + for _, file in pairs(self.output_names) do + local _, filename = file:match('(./+)(.*)') + f:write(filename, '\t', self.input_file or '', '\t', self.label or '', '\n') + end + f:close() +end + + +--[[ ========================== Public functions ========================== ]] + +ly.score_content = {} +function ly.buffenv_begin() + + function ly.buffenv(line) + table.insert(ly.score_content, line) + if line:find([[\end{%w+}]]) then return end + return '' + end + + ly.score_content = {} + luatexbase.add_to_callback('process_input_buffer', ly.buffenv, 'readline') +end + + +function ly.buffenv_end() + luatexbase.remove_from_callback('process_input_buffer', 'readline') + table.remove(ly.score_content) +end + + +function ly.clean_tmp_dir() + local hash, file_is_used + local hash_list = {} + for file in lfs.dir(Score.tmpdir) do + if file:sub(-5, -1) == '.list' then + local i = io.open(Score.tmpdir..'/'..file) + for _, line in ipairs(i:read('*a'):explode('\n')) do + hash = line:explode('\t')[1] + if hash ~= '' then table.insert(hash_list, hash) end + end + i:close() + end + end + for file in lfs.dir(Score.tmpdir) do + if file ~= '.' and file ~= '..' and file:sub(-5, -1) ~= '.list' then + for _, lhash in ipairs(hash_list) do + file_is_used = file:find(lhash) + if file_is_used then break end + end + if not file_is_used then os.remove(Score.tmpdir..'/'..file) end + end + end +end + + +function ly.conclusion_text() + info([[ +Output written on %s.pdf. +Transcript written on %s.log. +]], + tex.jobname, tex.jobname + ) +end + + +function ly.declare_package_options(options) + OPTIONS = options + local exopt = '' + for k, v in pairs(options) do + tex.sprint(string.format([[ +\DeclareOptionX{%s}{\directlua{ + ly.set_property('%s', '\luatexluaescapestring{#1}') +}}%% +]], + k, k + )) + exopt = exopt..k..'='..(v[1] or '')..',' + end + tex.sprint([[\ExecuteOptionsX{]]..exopt..[[}%%]], [[\ProcessOptionsX]]) + mkdirs(options.tmpdir[1]) + FILELIST = options.tmpdir[1]..'/'..splitext(status.log_name, 'log')..'.list' + os.remove(FILELIST) +end + + +function ly.env_begin(opts) + ly.state = 'env' + ly.env_no_args = opts == 'noarg' + if ly.env_no_args then tex.sprint(40, [[\ly@compilely]]) + else tex.sprint(40, [[\ly@bufferenv]]) + end +end + + +function ly.env_end() + if ly.env_no_args then tex.sprint(40, [[\endly@compilely]]) + else tex.sprint(40, [[\endly@bufferenv]]) + end +end + + +function ly.file(input_file, options) + --[[ Here, we only take in account global option includepaths, + as it really doesn't mean anything as a local option. ]] + local file = locate(input_file, Score.includepaths, '.ly') + options = ly.set_local_options(options) + if not file then err("File %s doesn't exist.", input_file) end + local i = io.open(file, 'r') + ly.score = Score:new(i:read('*a'), options, file) + i:close() +end + + +function ly.file_musicxml(input_file, options) + --[[ Here, we only take in account global option includepaths, + as it really doesn't mean anything as a local option. ]] + local file = locate(input_file, Score.includepaths, '.xml') + options = ly.set_local_options(options) + if not file then err("File %s doesn't exist.", input_file) end + local xmlopts = '' + for _, opt in pairs(MXML_OPTIONS) do + if options[opt] ~= nil then + if options[opt] then xmlopts = xmlopts..' --'..opt + if options[opt] ~= 'true' and options[opt] ~= '' then + xmlopts = xmlopts..' '..options[opt] + end + end + elseif ly.get_option(opt) then xmlopts = xmlopts..' --'..opt + end + end + local i = io.popen(ly.get_option('xml2ly')..' --out=-'..xmlopts..' "'..file..'"', 'r') + if not i then + err([[ +LilyPond could not be started. +Please check that LuaLaTeX is started with the +--shell-escape option. +]] + ) + end + ly.score = Score:new(i:read('*a'), options, file) + i:close() +end + + +function ly.fragment(ly_code, options) + options = ly.set_local_options(options) + if type(ly_code) == 'string' then + ly_code = ly_code:gsub('\\par ', '\n'):gsub('\\([^%s]*) %-([^%s])', '\\%1-%2') + else ly_code = table.concat(ly_code, '\n') + end + ly.score = Score:new(ly_code, options) +end + + +function ly.get_font_family(font_id) + return fontinfo(font_id).shared.rawdata.metadata['familyname'] +end + + +function ly.get_option(opt) return Score[opt] end + + +function ly.is_alias() end + + +function ly.is_dim(k, v) + if v == '' or v == false or tonumber(v) then return true end + local n, sl, u = v:match('^%d*%.?%d*'), v:match('\\'), v:match('%a+') + -- a value of number - backslash - length is a dimension + -- invalid input will be prevented in by the LaTeX parser already + if n and sl and u then return true end + if n and contains(TEX_UNITS, u) then return true end + err([[ +Unexpected value "%s" for dimension %s: +should be either a number (for example "12"), +a number with unit, without space ("12pt"), +or a (multiplied) TeX length (".8\linewidth") +]], + v, k + ) +end + + +function ly.is_neg(k, _) + local _, i = k:find('^no') + return i and contains_key(OPTIONS, k:sub(i + 1)) +end + + +function ly.is_num(_, v) return v == '' or tonumber(v) end + + +function ly.newpage_if_fullpage() + if ly.score.insert == 'fullpage' then tex.sprint([[\newpage]]) end +end + + +function ly.set_fonts(rm, sf, tt) +if ly.score.rmfamily..ly.score.sffamily..ly.score.ttfamily ~= '' then + ly.score['pass-fonts'] = 'true' + info("At least one font family set explicitly. Activate 'pass-fonts'") +end + if ly.score.rmfamily == '' then ly.score.rmfamily = ly.get_font_family(rm) + else + -- if explicitly set don't override rmfamily with 'current' font + if ly.score['current-font-as-main'] then + info("rmfamily set explicitly. Deactivate 'current-font-as-main'") + end + ly.score['current-font-as-main'] = false + end + if ly.score.sffamily == '' then ly.score.sffamily = ly.get_font_family(sf) end + if ly.score.ttfamily == '' then ly.score.ttfamily = ly.get_font_family(tt) end +end + +function ly.set_local_options(opts) + local options = {} + local next_opt = opts:gmatch('([^,]+)') -- iterator over options + for opt in next_opt do + local k, v = opt:match('([^=]+)=?(.*)') + if k then + if v and v:sub(1, 1) == '{' then -- handle keys with {multiple, values} + while v:sub(-1) ~= '}' do v = v..','..next_opt() end + v = v:sub(2, -2) -- remove { } + end + k, v = process_options(k:gsub('^%s', ''), v:gsub('^%s', '')) + if k then + if options[k] then err('Option %s is set two times for the same score.', k) + else options[k] = v + end + end + end end - return font.fonts[id] + return options +end + + +function ly.set_property(k, v) + k, v = process_options(k, v) + if k then Score[k] = v end end -mkdirs(TMP) +return ly |