X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=ly%2Fmusic-functions-init.ly;h=e914b70326435296f9968343badc6d16fa7f3b78;hb=8be47fcb0708d3c1d9f7749be6b89bcdb35c720a;hp=141d107cd688f4aa2e2f7a31514ac0e0684afaad;hpb=af0801e09f8952dd4b20b8543d00279394b9fb3a;p=lilypond.git diff --git a/ly/music-functions-init.ly b/ly/music-functions-init.ly index 141d107cd6..e914b70326 100644 --- a/ly/music-functions-init.ly +++ b/ly/music-functions-init.ly @@ -1,27 +1,25 @@ % -*-Scheme-*- -\version "2.9.12" +\version "2.10.0" -%% need SRFI-1 filter -#(use-modules (srfi srfi-1)) -%% FIXME: guile-1.7 required? -%#(use-modules (scm display-lily))invalid module name for use-syntax ((srfi srfi-39)) +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% this file is alphabetically sorted. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -#(use-modules (scm display-lily)) -#(display-lily-init parser) +%% need SRFI-1 filter +#(use-modules (srfi srfi-1)) acciaccatura = #(def-grace-function startAcciaccaturaMusic stopAcciaccaturaMusic) -addquote = +addQuote = #(define-music-function (parser location name music) (string? ly:music?) - "Add a piece of music to be quoted " - (add-quotable name music) + (_i "Add a piece of music to be quoted ") + (add-quotable parser name music) (make-music 'SequentialMusic 'void #t)) - afterGraceFraction = #(cons 6 8) @@ -91,7 +89,7 @@ assertBeamSlope = autochange = #(define-music-function (parser location music) (ly:music?) - (make-autochange-music music)) + (make-autochange-music parser music)) applyContext = #(define-music-function (parser location proc) (procedure?) @@ -99,6 +97,24 @@ applyContext = 'origin location 'procedure proc)) + +balloonText = +#(define-music-function (parser location offset text) (number-pair? markup?) + + (make-music 'AnnotateOutputEvent + 'X-offset (car offset) + 'Y-offset (cdr offset) + 'text text)) + +balloonGrobText = +#(define-music-function (parser location grob-name offset text) (symbol? number-pair? markup?) + + (make-music 'AnnotateOutputEvent + 'symbol grob-name + 'X-offset (car offset) + 'Y-offset (cdr offset) + 'text text)) + bar = #(define-music-function (parser location type) (string?) @@ -115,7 +131,7 @@ barNumberCheck = (lambda (c) (let* ((cbn (ly:context-property c 'currentBarNumber))) - (if (not (= cbn n)) + (if (and (number? cbn) (not (= cbn n))) (ly:input-message location "Barcheck failed got ~a expect ~a" cbn n)))))) @@ -125,7 +141,7 @@ breathe = #(define-music-function (parser location) () (make-music 'EventChord 'origin location - 'elements (list (make-music 'BreathingSignEvent)))) + 'elements (list (make-music 'BreathingEvent)))) bendAfter = #(define-music-function (parser location delta) (integer?) @@ -136,8 +152,7 @@ bendAfter = clef = #(define-music-function (parser location type) (string?) - - "Set the current clef." + (_i "Set the current clef.") (make-clef-set type)) @@ -160,22 +175,25 @@ cueDuring = 'quoted-voice-direction dir 'origin location)) +%% The following causes an error with guile 1.6.8 (guile 1.6.7 and 1.8.x are fine) +#(use-modules (scm display-lily)) displayLilyMusic = #(define-music-function (parser location music) (ly:music?) - (display-lily-music music) + (newline) + (display-lily-music music parser) music) displayMusic = #(define-music-function (parser location music) (ly:music?) - (display-scheme-music music) - music) + (newline) + (display-scheme-music music) + music) featherDurations= #(define-music-function (parser location factor argument) (ly:moment? ly:music?) - - "Rearrange durations in ARGUMENT so there is an -acceleration/deceleration. " + (_i "Rearrange durations in ARGUMENT so there is an +acceleration/deceleration. ") (let* ((orig-duration (ly:music-length argument)) @@ -201,6 +219,39 @@ acceleration/deceleration. " grace = #(def-grace-function startGraceMusic stopGraceMusic) + +"instrument-definitions" = #'() + +addInstrumentDefinition = +#(define-music-function + (parser location name lst) (string? list?) + + (set! instrument-definitions (acons name lst instrument-definitions)) + + (make-music 'SequentialMusic 'void #t)) + + +instrumentSwitch = +#(define-music-function + (parser location name) (string?) + (let* + ((handle (assoc name instrument-definitions)) + (instrument-def (if handle (cdr handle) '())) + ) + + (if (not handle) + (ly:input-message "No such instrument: ~a" name)) + (context-spec-music + (make-music 'SimultaneousMusic + 'elements + (map (lambda (kv) + (make-property-set + (car kv) + (cdr kv))) + instrument-def)) + 'Staff))) + + keepWithTag = #(define-music-function (parser location tag music) (symbol? ly:music?) @@ -250,9 +301,9 @@ overrideProperty = (string? symbol? scheme?) - "Set @var{property} to @var{value} in all grobs named @var{name}. + (_i "Set @var{property} to @var{value} in all grobs named @var{name}. The @var{name} argument is a string of the form @code{\"Context.GrobName\"} -or @code{\"GrobName\"}" +or @code{\"GrobName\"}") (let* ((name-components (string-split name #\.)) @@ -290,10 +341,9 @@ removeWithTag = %% doing %% define-music-function in a .scm causes crash. - octave = #(define-music-function (parser location pitch-note) (ly:music?) - "octave check" + (_i "octave check") (make-music 'RelativeOctaveCheck 'origin location @@ -301,7 +351,8 @@ octave = )) partcombine = #(define-music-function (parser location part1 part2) (ly:music? ly:music?) - (make-part-combine-music (list part1 part2))) + (make-part-combine-music parser + (list part1 part2))) pitchedTrill = @@ -330,22 +381,20 @@ pitchedTrill = (display sec-note-events))) main-note)) - - - - - parenthesize = #(define-music-function (parser loc arg) (ly:music?) - "Tag @var{arg} to be parenthesized." + (_i "Tag @var{arg} to be parenthesized.") (set! (ly:music-property arg 'parenthesize) #t) arg) +%% for lambda* +#(use-modules (ice-9 optargs)) + parallelMusic = #(define-music-function (parser location voice-ids music) (list? ly:music?) - "Define parallel music sequences, separated by '|' (bar check signs), + (_i "Define parallel music sequences, separated by '|' (bar check signs), and assign them to the identifiers provided in @var{voice-ids}. @var{voice-ids}: a list of music identifiers (symbols containing only letters) @@ -353,6 +402,8 @@ and assign them to the identifiers provided in @var{voice-ids}. @var{music}: a music sequence, containing BarChecks as limiting expressions. Example: + +@verbatim \\parallelMusic #'(A B C) { c c | d d | e e | d d | e e | f f | @@ -361,7 +412,8 @@ Example: A = { c c | d d | } B = { d d | e e | } C = { e e | f f | } -" +@end verbatim +") (let* ((voices (apply circular-list (make-list (length voice-ids) (list)))) (current-voices voices) (current-sequence (list))) @@ -412,7 +464,7 @@ Example: voices) ;; ;; check sequence length - (apply for-each (lambda (. seqs) + (apply for-each (lambda* (#:rest seqs) (let ((moment-reference (ly:music-length (car seqs)))) (for-each (lambda (seq moment) (if (not (equal? moment moment-reference)) @@ -448,7 +500,7 @@ resetRelativeOctave = #(define-music-function (parser location reference-note) (ly:music?) - "Set the octave inside a \\relative section." + (_i "Set the octave inside a \\relative section.") (let* ((notes (ly:music-property reference-note 'elements)) @@ -466,30 +518,77 @@ resetRelativeOctave = shiftDurations = #(define-music-function (parser location dur dots arg) (integer? integer? ly:music?) - "" - + (_i "") (music-map (lambda (x) (shift-one-duration-log x dur dots)) arg)) - -%% this is a stub. Write your own to suit the spacing tweak output. spacingTweaks = #(define-music-function (parser location parameters) (list?) + (_i "Set the system stretch, by reading the 'system-stretch property of +the `parameters' assoc list.") + #{ + \overrideProperty #"Score.NonMusicalPaperColumn" + #'line-break-system-details + #$(list (cons 'alignment-extra-space (cdr (assoc 'system-stretch parameters))) + (cons 'system-Y-extent (cdr (assoc 'system-Y-extent parameters)))) + #}) + +%% Parser used to read page-layout file, and then retreive score tweaks. +#(define page-layout-parser #f) + +includePageLayoutFile = +#(define-music-function (parser location) () + (_i "If page breaks and tweak dump is not asked, and the file +-page-layout.ly exists, include it.") + (if (not (ly:get-option 'dump-tweaks)) + (let ((tweak-filename (format #f "~a-page-layout.ly" + (ly:parser-output-name parser)))) + (if (access? tweak-filename R_OK) + (begin + (ly:message "Including tweak file ~a" tweak-filename) + (set! page-layout-parser (ly:parser-clone parser)) + (ly:parser-parse-string page-layout-parser + (format #f "\\include \"~a\"" + tweak-filename)))))) (make-music 'SequentialMusic 'void #t)) -transposedCueDuring = # -(define-music-function +rightHandFinger = +#(define-music-function (parser location finger) (number-or-string?) + (_i "Define a StrokeFingerEvent") + + (apply make-music + (append + (list + 'StrokeFingerEvent + 'origin location) + (if (string? finger) + (list 'text finger) + (list 'digit finger))))) + +scoreTweak = +#(define-music-function (parser location name) (string?) + (_i "Include the score tweak, if exists.") + (if (and page-layout-parser (not (ly:get-option 'dump-tweaks))) + (let ((tweak-music (ly:parser-lookup page-layout-parser + (string->symbol name)))) + (if (ly:music? tweak-music) + tweak-music + (make-music 'SequentialMusic))) + (make-music 'SequentialMusic))) + +transposedCueDuring = +#(define-music-function (parser location what dir pitch-note main-music) (string? ly:dir? ly:music? ly:music?) - "Insert notes from the part @var{what} into a voice called @code{cue}, + (_i "Insert notes from the part @var{what} into a voice called @code{cue}, using the transposition defined by @var{pitch-note}. This happens simultaneously with @var{main-music}, which is usually a rest. The argument @var{dir} determines whether the cue notes should be notated -as a first or second voice." +as a first or second voice.") (make-music 'QuoteMusic 'element main-music @@ -502,13 +601,19 @@ as a first or second voice." +transposition = +#(define-music-function (parser location pitch-note) (ly:music?) + (_i "Set instrument transposition") + (context-spec-music + (make-property-set 'instrumentTransposition + (ly:pitch-negate (pitch-of-note pitch-note))) + 'Staff)) tweak = #(define-music-function (parser location sym val arg) (symbol? scheme? ly:music?) - "Add @code{sym . val} to the @code{tweaks} property of @var{arg}." - + (_i "Add @code{sym . val} to the @code{tweaks} property of @var{arg}.") (set! (ly:music-property arg 'tweaks) @@ -519,7 +624,7 @@ tweak = #(define-music-function (parser location sym val arg) tag = #(define-music-function (parser location tag arg) (symbol? ly:music?) - "Add @var{tag} to the @code{tags} property of @var{arg}." + (_i "Add @var{tag} to the @code{tags} property of @var{arg}.") (set! (ly:music-property arg 'tags) @@ -531,3 +636,14 @@ tag = #(define-music-function (parser location tag arg) unfoldRepeats = #(define-music-function (parser location music) (ly:music?) (unfold-repeats music)) + + + +withMusicProperty = +#(define-music-function (parser location sym val music) (symbol? scheme? ly:music?) + (_i "Set @var{sym} to @var{val} in @var{music}.") + + (set! (ly:music-property music sym) val) + music) + +