;;;;
;;;; source file of the GNU LilyPond music typesetter
;;;;
-;;;; (c) 1998--2004 Jan Nieuwenhuizen <janneke@gnu.org>
-;;;; Han-Wen Nienhuys <hanwen@cs.uu.nl>
+;;;; (c) 1998--2008 Jan Nieuwenhuizen <janneke@gnu.org>
+;;;; Han-Wen Nienhuys <hanwen@xs4all.nl>
+
+
+;; The public interface is tight.
+;; It has to be, because user-code is evalled with this module.
+
+;; ***It should also be clean, well defined, documented and reviewed***
+
+;; To be reasonably safe, you probably do not want to use the TeX
+;; backend anyway, but rather the PostScript backend. You may want
+;; to run gs in a uml sandbox too.
+
+
+(define-module (scm output-tex)
+ #:re-export (quote)
+
+ ;; JUNK this -- see lily.scm: ly:all-output-backend-commands
+ #:export (unknown
+ blank
+ circle
+ dot
+ dashed-slur
+ named-glyph
+ dashed-line
+ comment
+ repeat-slash
+ placebox
+ bezier-sandwich
+ round-filled-box
+ text
+ setcolor
+ resetcolor
+ polygon
+ draw-line
+ no-origin
+ grob-cause))
-
-;; (debug-enable 'backtrace)
-(define-module (scm output-tex))
(use-modules (ice-9 regex)
(ice-9 string-fun)
- (ice-9 format)
(guile)
(srfi srfi-13)
+ (scm framework-tex)
(lily))
-(define this-module (current-module))
-
-;; dumper-compatibility
-(define output-ps #f)
-(define (ps-output-expression expr port)
- (if (not output-ps)
- (let ((ps-module (resolve-module '(scm output-ps))))
- (eval '(use-modules (guile) (ice-9 regex) (srfi srfi-13) (lily))
- ps-module)
- (set! output-ps ps-module)))
- (display (eval expr output-ps) port))
-;;; Output interface entry
-(define-public (tex-output-expression expr port)
- (display (eval expr this-module) port ))
;;;;;;;;
;;;;;;;; DOCUMENT ME!
;;;;;;;;
-(define font-name-alist '())
-
-(define (tex-encoded-fontswitch name-mag)
- (let* ((iname-mag (car name-mag))
- (ename-mag (cdr name-mag)))
-
- (cons iname-mag
- (cons ename-mag
- (string-append "magfont"
- (string-encode-integer
- (hashq (car ename-mag) 1000000))
- "m"
- (string-encode-integer
- (inexact->exact (round (* 1000 (cdr ename-mag))))))))))
-
-(define (define-fonts internal-external-name-mag-pairs)
- (set! font-name-alist (map tex-encoded-fontswitch
- internal-external-name-mag-pairs))
- (apply string-append
- (map (lambda (x)
- (font-load-command (car x) (cdr x)))
- (map cdr font-name-alist))))
-
-;;
-;; urg, how can exp be #unspecified? -- in sketch output
-;;
-;; set! returns #<unspecified> --hwn
-;;
-(define (fontify name-mag-pair exp)
- (string-append (select-font name-mag-pair)
- exp))
+(define (char font i)
+ (string-append "\\" (tex-font-command font)
+ "\\char" (ly:inexact->string i 10) " "))
(define (unknown)
"%\n\\unknown\n")
-(define (symbol->tex-key sym)
- (regexp-substitute/global
- #f "_" (output-tex-string (symbol->string sym)) 'pre "X" 'post) )
-
-(define (tex-string-def prefix key str)
- (if (equal? "" (sans-surrounding-whitespace (output-tex-string str)))
- (string-append "\\let\\" prefix (symbol->tex-key key) "\\undefined%\n")
- (string-append "\\def\\" prefix (symbol->tex-key key) "{" (output-tex-string str) "}%\n")
- ))
-
-(define (tex-number-def prefix key number)
- (string-append "\\def\\" prefix (symbol->tex-key key) "{" number "}%\n"))
-
-(define (output-paper-def pd)
- (apply
- string-append
- (module-map
- (lambda (sym var)
- (let ((val (variable-ref var))
- (key (symbol->tex-key sym)))
-
- (cond
- ((string? val)
- (tex-string-def "lilypondpaper" sym val))
- ((number? val)
- (tex-number-def "lilypondpaper" sym
- (if (integer? val)
- (number->string val)
- (number->string (exact->inexact val)))))
- (else ""))))
-
- (ly:output-def-scope pd))))
-
-(define (output-scopes paper scopes fields basename)
- (define (output-scope scope)
- (apply
- string-append
- (module-map
- (lambda (sym var)
- (let ((val (variable-ref var))
- ;;(val (if (variable-bound? var) (variable-ref var) '""))
- (tex-key (symbol->string sym)))
-
- (if (and (memq sym fields) (string? val))
- (header-to-file basename sym val))
-
- (cond
- ((string? val)
- (tex-string-def "lilypond" sym val))
- ((number? val)
- (tex-number-def "lilypond" sym
- (if (integer? val)
- (number->string val)
- (number->string (exact->inexact val)))))
- (else ""))))
- scope)))
-
- (apply string-append
- (map output-scope scopes)))
-
-(define (select-font name-mag-pair)
- (let ((c (assoc name-mag-pair font-name-alist)))
- (if c
- (string-append "\\" (cddr c))
- (begin
- (ly:warn
- (format "Programming error: No such font: ~S" name-mag-pair))
- ""))))
+(define (url-link url x y)
+ "")
(define (blank)
"")
+(define (circle radius thick)
+ (embedded-ps (list 'circle radius thick)))
+
(define (dot x y radius)
(embedded-ps (list 'dot x y radius)))
-(define (beam width slope thick blot)
- (embedded-ps (list 'beam width slope thick blot)))
-
-(define (bracket arch_angle arch_width arch_height height arch_thick thick)
- (embedded-ps (list 'bracket arch_angle arch_width arch_height height arch_thick thick)))
+(define (embedded-ps string)
+ (embedded-ps (list 'embedded-ps string)))
+
+(define (dashed-slur thick on off lst)
+ (embedded-ps (list 'dashed-slur thick on off `(quote ,lst))))
+
+(define (named-glyph font name)
+ (let* ((info (ly:otf-font-glyph-info font name))
+ (subfont (assoc-get 'subfont info))
+ (subidx (assoc-get 'subfont-index info)))
+
+ ;;(stderr "INFO: ~S\n" info)
+ ;;(stderr "FONT: ~S\n" font)
+ (if (and subfont subidx)
+ (string-append "\\" (tex-font-command-raw
+ subfont
+ (ly:font-magnification font))
+ "\\char" (number->string subidx))
-(define (dashed-slur thick dash l)
- (embedded-ps (list 'dashed-slur thick dash `(quote ,l))))
-
-(define (char i)
- (string-append "\\char" (inexact->string i 10) " "))
-
-(define (dashed-line thick on off dx dy)
- (embedded-ps (list 'dashed-line thick on off dx dy)))
-
-(define (zigzag-line centre? zzw zzh thick dx dy)
- (embedded-ps (list 'zigzag-line centre? zzw zzh thick dx dy)))
-
-(define (symmetric-x-triangle t w h)
- (embedded-ps (list 'symmetric-x-triangle t w h)))
+ (begin
+ (ly:warning (_ "cannot find ~a in ~a" name font))
+ ""))))
-(define (font-load-command name-mag command)
- (string-append
- "\\font\\" command "="
- (car name-mag)
- " scaled "
- (ly:number->string (inexact->exact (round (* 1000 (cdr name-mag)))))
- "\n"))
-
-(define (ez-ball c l b)
- (embedded-ps (list 'ez-ball c l b)))
-
-(define (header-to-file fn key val)
- (set! key (symbol->string key))
- (if (not (equal? "-" fn))
- (set! fn (string-append fn "." key))
- )
- (display
- (format "writing header field `~a' to `~a'..."
- key
- (if (equal? "-" fn) "<stdout>" fn)
- )
- (current-error-port))
- (if (equal? fn "-")
- (display val)
- (display val (open-file fn "w"))
- )
- (display "\n" (current-error-port))
- ""
- )
+(define (dashed-line thick on off dx dy phase)
+ (embedded-ps (list 'dashed-line thick on off dx dy phase)))
(define (embedded-ps expr)
(let ((ps-string
(with-output-to-string
(lambda () (ps-output-expression expr (current-output-port))))))
(string-append "\\embeddedps{" ps-string "}")))
-
-(define (comment s)
- (string-append "% " s "\n"))
-
-(define (end-output)
- (begin
- ;; uncomment for some stats about lily memory
- ;; (display (gc-stats))
- (string-append
- "\\lilypondend\n"
- ;; Put GC stats here.
- )))
-
-(define (experimental-on)
- "")
(define (repeat-slash w a t)
(embedded-ps (list 'repeat-slash w a t)))
-(define (header-end)
- (string-append
- "\\def\\scaletounit{ "
- (number->string (cond
- ((equal? (ly:unit) "mm") (/ 72.0 25.4))
- ((equal? (ly:unit) "pt") (/ 72.0 72.27))
- (else (error "unknown unit" (ly:unit)))
- ))
- " mul }%\n"
- "\\ifx\\lilypondstart\\undefined\n"
- " \\input lilyponddefs\n"
- "\\fi\n"
- "\\outputscale = \\lilypondpaperoutputscale\\lilypondpaperunit\n"
- "\\lilypondstart\n"
- "\\lilypondspecial\n"
- "\\lilypondpostscript\n"))
-
-(define (header creator time-stamp page-count)
- (string-append
- "% Generated by " creator "\n"
- "% at " time-stamp "\n"
- ;; FIXME: duplicated in every backend
- "\\def\\lilypondtagline{Engraved by LilyPond (version "
- (lilypond-version)")}\n"))
-
-(define (invoke-char s i)
- (string-append
- "\n\\" s "{" (inexact->string i 10) "}" ))
-
-;; FIXME: explain ploblem: need to do something to make this really safe.
-(define-public (output-tex-string s)
- (if safe-mode?
- (regexp-substitute/global #f "\\\\" s 'pre "$\\backslash$" 'post)
- s))
-
-(define (lily-def key val)
- (let ((tex-key
- (regexp-substitute/global
- #f "_" (output-tex-string key) 'pre "X" 'post))
-
- (tex-val (output-tex-string val)))
- (if (equal? (sans-surrounding-whitespace tex-val) "")
- (string-append "\\let\\" tex-key "\\undefined\n")
- (string-append "\\def\\" tex-key "{" tex-val "}%\n"))))
-
(define (number->dim x)
(string-append
;;ugh ly:* in backend needs compatibility func for standalone output
- (ly:number->string x) " \\outputscale "))
+ (ly:number->string x) " \\output-scale "))
(define (placebox x y s)
- (string-append "\\lyitem{"
- (ly:number->string y) "}{"
- (ly:number->string x) "}{"
- s "}%\n"))
-
-(define (bezier-sandwich l thick)
- (embedded-ps (list 'bezier-sandwich `(quote ,l) thick)))
-
-(define (start-system wd ht)
- (string-append "\\leavevmode\n"
- "\\scoreshift = " (number->dim (* ht 0.5)) "\n"
- "\\lilypondifundefined{lilypondscoreshift}%\n"
- " {}%\n"
- " {\\advance\\scoreshift by -\\lilypondscoreshift}%\n"
- "\\lybox{"
- (ly:number->string wd) "}{"
- (ly:number->string ht) "}{%\n"))
-
-(define (stop-system)
- "}%\n%\n\\interscoreline\n%\n")
-(define (stop-last-system)
- "}%\n")
-
-(define (horizontal-line x1 x2 th)
- (filledbox (- x1) (- x2 x1) (* .5 th) (* .5 th )))
-
-(define (filledbox breapth width depth height)
- (if (and #f (defined? 'ps-testing))
- (embedded-ps
- (string-append (numbers->string (list breapth width depth height))
- " draw_box" ))
- (string-append "\\lyvrule{"
- (ly:number->string (- breapth)) "}{"
- (ly:number->string (+ breapth width)) "}{"
- (ly:number->string depth) "}{"
- (ly:number->string height) "}")))
+ (string-append
+ "\\lyitem{" (ly:number->string x) "}{" (ly:number->string y) "}{" s "}%\n"))
+
+(define (bezier-sandwich lst thick)
+ (embedded-ps (list 'bezier-sandwich `(quote ,lst) thick)))
+
(define (round-filled-box x y width height blotdiam)
(embedded-ps (list 'round-filled-box x y width height blotdiam)))
-(define (text s)
- (string-append "\\hbox{" (output-tex-string s) "}"))
+(define (text font s)
+ (format #f
+ "\\hbox{\\~a{}~a}" (tex-font-command font)
+ (sanitize-tex-string s)))
-(define (tuplet ht gapx dx dy thick dir)
- (embedded-ps (list 'tuplet ht gapx dx dy thick dir)))
+(define (setcolor r g b)
+ (string-append "\\color[rgb]{"
+ (number->string r) ", "
+ (number->string g) ", "
+ (number->string b) "}"))
-(define (polygon points blotdiameter)
- (embedded-ps (list 'polygon `(quote ,points) blotdiameter)))
+;; FIXME
+;; The PostScript backend saves the current color
+;; during setcolor and restores it during resetcolor.
+;; We don't do that here.
+(define (resetcolor)
+ (string-append "\\color[rgb]{0,0,0}\n"))
+
+(define (polygon points blot-diameter fill)
+ (embedded-ps (list 'polygon `(quote ,points) blot-diameter fill)))
(define (draw-line thick fx fy tx ty)
(embedded-ps (list 'draw-line thick fx fy tx ty)))
-;; TODO: this should be a default, which is overriden in PS
-(define (between-system-string string)
- string
- )
-(define (define-origin file line col)
- (if (procedure? point-and-click)
- (string-append "\\special{src:" ;;; \\string ?
- (point-and-click line col file)
- "}" )
- "")
- )
-
;; no-origin not yet supported by Xdvi
(define (no-origin) "")
-(define (start-page)
- "\n%\\vbox{\n")
-(define (stop-page last?)
- (if last?
- "\n%}\n"
- "\n%}\n\\newpage\n"))
+(define-public (line-location file line col)
+ "Print an input location, without column number ."
+ (string-append (number->string line) " " file))
+
+(define-public point-and-click #f)
+
+(define (grob-cause offset grob)
+ (define (line-column-location file line col)
+ "Print an input location, including column number ."
+ (string-append (number->string line) ":"
+ (number->string col) " " file))
+
+ (if (procedure? point-and-click)
+ (let* ((cause (ly:grob-property grob 'cause))
+ (music-origin (if (ly:stream-event? cause)
+ (ly:event-property cause 'origin)))
+ (location (if (ly:input-location? music-origin)
+ (ly:input-file-line-column music-origin))))
+ (if (pair? location)
+ ;;; \\string ?
+ (string-append "\\special{src:"
+ (line-column-location location) "}")
+ ""))
+ ""))