1 ;;;; framework-ps.scm -- structure for PostScript output
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 2004--2008 Han-Wen Nienhuys <hanwen@xs4all.nl>
7 (define-module (scm framework-ps))
9 ;;; this is still too big a mess.
11 (use-modules (ice-9 string-fun)
20 (define format ergonomic-simple-format)
22 (define framework-ps-module (current-module))
24 ;;(define pdebug stderr)
25 (define (pdebug . rest) #f)
27 (define-public (ps-font-command font)
28 (let* ((name (ly:font-file-name font))
29 (magnify (ly:font-magnification font)))
38 "m" (string-encode-integer (inexact->exact (round (* 1000 magnify)))))))
40 (define (define-fonts paper)
41 (define font-list (ly:paper-fonts paper))
43 (define (define-font command fontname scaling)
47 " " (ly:number->string scaling) " output-scale div selectfont }"
50 (define (font-load-command font)
51 (let* ((specced-font-name (ly:font-name font))
52 (fontname (if specced-font-name
54 (ly:font-file-name font)))
55 (command (ps-font-command font))
57 ;; FIXME -- see (ps-font-command)
58 (plain (ps-font-command font))
59 (designsize (ly:font-design-size font))
60 (magnification (* (ly:font-magnification font)))
61 (ops (ly:output-def-lookup paper 'output-scale))
62 (scaling (* ops magnification designsize)))
63 (if (equal? fontname "unknown")
64 (display (list font fontname)))
65 (define-font plain fontname scaling)))
68 (map (lambda (x) (font-load-command x))
69 (filter (lambda (x) (not (ly:pango-font? x)))
72 ;; FIXME: duplicated in other output backends
73 ;; FIXME: silly interface name
74 (define (output-variables layout)
75 ;; FIXME: duplicates output-layout's scope-entry->string, mostly
76 (define (value->string val)
78 ((string? val) (string-append "(" val ")"))
79 ((symbol? val) (symbol->string val))
80 ((number? val) (number->string val))
83 (define (output-entry ps-key ly-key)
86 (value->string (ly:output-def-lookup layout ly-key)) " def\n"))
90 (number->string (/ (ly:bp 1))) " def %% millimeter\n"
91 (output-entry "staff-line-thickness" 'line-thickness)
92 (output-entry "line-width" 'line-width)
93 (output-entry "paper-size" 'papersizename)
94 (output-entry "staff-height" 'staff-height) ;junkme.
96 (number->string (ly:output-def-lookup layout 'output-scale)) " def\n"
97 (output-entry "page-height" 'paper-height)
98 (output-entry "page-width" 'paper-width)))
100 (define (dump-page outputter page page-number page-count landscape?)
101 (ly:outputter-dump-string
104 (format "%%Page: ~a ~a\n" page-number page-number)
107 "page-width output-scale lily-output-units mul mul 0 translate 90 rotate\n"
111 "true setstrokeadjust\n"
112 "gsave 0 paper-height translate set-ps-scale-to-lily-scale\n"))
113 (ly:outputter-dump-stencil outputter page)
114 (ly:outputter-dump-string outputter "stroke grestore\nshowpage\n"))
116 (define (supplies-or-needs paper load-fonts?)
117 (define (extract-names font)
118 (if (ly:pango-font? font)
119 (map car (ly:pango-font-physical-fonts font))
120 (list (ly:font-name font))))
122 (let* ((fonts (ly:paper-fonts paper))
123 (names (apply append (map extract-names fonts))))
128 "%%DocumentSuppliedResources: font ~a\n"
129 "%%DocumentNeededResources: font ~a\n")
131 (uniq-list (sort names string<?))))))
133 (define (eps-header paper bbox load-fonts?)
134 (string-append "%!PS-Adobe-2.0 EPSF-2.0\n"
135 "%%Creator: LilyPond " (lilypond-version) "\n"
137 (string-join (map ly:number->string bbox) " ") "\n"
139 (if (eq? (ly:output-def-lookup paper 'landscape) #t)
142 (supplies-or-needs paper load-fonts?)
145 (define (ps-document-media paper)
147 (ly:output-def-lookup paper 'output-scale)
148 (ly:output-def-lookup paper 'paper-width)) (ly:bp 1)))
150 (ly:output-def-lookup paper 'paper-height)
151 (ly:output-def-lookup paper 'output-scale))
153 (landscape? (eq? (ly:output-def-lookup paper 'landscape) #t)))
154 (ly:format "%%DocumentMedia: ~a ~2f ~2f ~a ~a ~a\n"
155 (ly:output-def-lookup paper 'papersizename)
163 (define (file-header paper page-count load-fonts?)
164 (string-append "%!PS-Adobe-3.0\n"
165 "%%Creator: LilyPond " (lilypond-version) "\n"
166 "%%Pages: " (number->string page-count) "\n"
167 "%%PageOrder: Ascend\n"
169 (if (eq? (ly:output-def-lookup paper 'landscape) #t)
172 (ps-document-media paper)
173 (supplies-or-needs paper load-fonts?)
176 (define (procset file-name)
178 "%%BeginResource: procset (~a) 1 0
182 file-name (cached-file-contents file-name)))
184 (define (embed-document file-name)
185 (format "%%BeginDocument: ~a
189 file-name (cached-file-contents file-name)))
191 (define (setup-variables paper)
195 (output-variables paper)))
197 (define (cff-font? font)
198 (let* ((cff-string (ly:otf-font-table-data font "CFF ")))
199 (> (string-length cff-string) 0)))
201 (define-public (ps-embed-cff body font-set-name version)
204 (format "/~a ~s StartData " font-set-name (string-length body))
208 "%%BeginResource: font ~a
209 %!PS-Adobe-3.0 Resource-FontSet
210 %%DocumentNeededResources: ProcSet (FontSetInit)
211 %%Title: (FontSet/~a)
214 %%IncludeResource: ProcSet (FontSetInit)
215 %%BeginResource: FontSet (~a)
216 /FontSetInit /ProcSet findresource begin
217 %%BeginData: ~s Binary Bytes
219 font-set-name font-set-name version font-set-name
220 (string-length binary-data)))
224 (string-append header
228 (define (write-preamble paper load-fonts? port)
229 (define (internal-font? file-name)
230 (or (string-startswith file-name "Emmentaler")
231 (string-startswith file-name "emmentaler")
232 (string-startswith file-name "aybabtu")
233 (string-startswith file-name "Aybabtu")))
235 (define (load-font-via-GS font-name-filename)
236 (define (ps-load-file file-name)
237 (if (string? file-name)
238 (if (string-contains file-name (ly:get-option 'datadir))
240 (set! file-name (ly:string-substitute (ly:get-option 'datadir)
243 "lilypond-datadir (~a) concatstrings (r) file .loadfont\n"
245 (format "(~a) (r) file .loadfont\n" file-name))
246 (format "% cannot find font file: ~a\n" file-name)))
248 (let* ((font (car font-name-filename))
249 (name (cadr font-name-filename))
250 (file-name (caddr font-name-filename))
251 (bare-file-name (ly:find-file file-name)))
253 (if (mac-font? bare-file-name)
254 (handle-mac-font name bare-file-name)
256 ((internal-font? file-name)
257 (ps-load-file (ly:find-file
258 (format "~a.otf" file-name))))
259 ((string? bare-file-name)
260 (ps-load-file file-name))
262 (ly:warning (_ "cannot embed ~S=~S") name file-name)
265 (define (dir-join a b)
268 (string-append a "/" b)))
270 (define (dir-listing dir-name)
271 (define (dir-helper dir lst)
272 (let ((e (readdir dir)))
275 (dir-helper dir (cons e lst)))))
276 (reverse (dir-helper (opendir dir-name) '())))
278 (define (handle-mac-font name filename)
279 (let* ((dir-name (tmpnam))
283 (mkdir dir-name #o700)
284 (set! status (ly:system
285 (format "cd ~a && fondu -force '~a'" dir-name filename)))
286 (set! files (dir-listing dir-name))
289 (let* ((full-name (dir-join dir-name f)))
291 (equal? 'regular (stat:type (stat full-name)))
292 (equal? name (ly:ttf-ps-name full-name)))
293 (set! embed (font-file-as-ps-string name full-name)))
294 (if (or (equal? "." f)
297 (delete-file full-name))))
302 (set! embed "% failed\n")
303 (ly:warning (_ "cannot extract file matching ~a from ~a")
307 (define (font-file-as-ps-string name file-name font-index)
308 (let* ((downcase-file-name (string-downcase file-name)))
310 ((and file-name (string-endswith downcase-file-name ".pfa"))
311 (embed-document file-name))
312 ((and file-name (string-endswith downcase-file-name ".pfb"))
313 (ly:pfb->pfa file-name))
314 ((and file-name (string-endswith downcase-file-name ".ttf"))
315 (ly:ttf->pfa file-name))
316 ((and file-name (string-endswith downcase-file-name ".ttc"))
317 (ly:ttf->pfa file-name font-index))
318 ((and file-name (string-endswith downcase-file-name ".otf"))
319 (ps-embed-cff (ly:otf->cff file-name) name 0))
321 (ly:warning (_ "do not know how to embed ~S=~S") name file-name)
324 (define (mac-font? bare-file-name)
325 (and (eq? PLATFORM 'darwin)
327 (or (string-endswith bare-file-name ".dfont")
328 (= (stat:size (stat bare-file-name)) 0))))
330 (define (load-font font-psname-filename-fontindex)
331 (let* ((font (list-ref font-psname-filename-fontindex 0))
332 (name (list-ref font-psname-filename-fontindex 1))
333 (file-name (list-ref font-psname-filename-fontindex 2))
334 (font-index (list-ref font-psname-filename-fontindex 3))
335 (bare-file-name (ly:find-file file-name)))
337 (cond ((mac-font? bare-file-name)
338 (handle-mac-font name bare-file-name))
339 ((and font (cff-font? font))
340 (ps-embed-cff (ly:otf-font-table-data font "CFF ")
343 (bare-file-name (font-file-as-ps-string
344 name bare-file-name font-index))
346 (ly:warning (_ "do not know how to embed font ~s ~s ~s")
347 name file-name font))))))
349 (define (load-fonts paper)
350 (let* ((fonts (ly:paper-fonts paper))
352 ;; todo - doc format of list.
356 (cond ((string? (ly:font-file-name font))
359 (ly:font-file-name font)
361 ((ly:pango-font? font)
362 (map (lambda (psname-filename-fontindex)
364 (list-ref psname-filename-fontindex 0)
365 (list-ref psname-filename-fontindex 1)
366 (list-ref psname-filename-fontindex 2)))
367 (ly:pango-font-physical-fonts font)))
369 (ly:font-sub-fonts font))))
371 (font-names (uniq-list
372 (sort (apply append all-font-names)
373 (lambda (x y) (string<? (cadr x) (cadr y))))))
375 ;; slightly spaghetti-ish: deciding what to load where
379 (cond ((ly:get-option 'gs-load-fonts)
380 (load-font-via-GS name))
381 ((ly:get-option 'gs-load-lily-fonts)
382 (if (or (string-contains (caddr name)
383 (ly:get-option 'datadir))
384 (internal-font? (caddr name)))
385 (load-font-via-GS name)
389 (pfas (map font-loader font-names)))
392 (display "%%BeginProlog\n" port)
395 "/lilypond-datadir where {pop} {userdict /lilypond-datadir (~a) put } ifelse"
396 (ly:get-option 'datadir))
398 (for-each (lambda (f)
399 (format port "\n%%BeginFont: ~a\n" (car f))
400 (display (cdr f) port)
401 (display "%%EndFont\n" port))
403 (display (setup-variables paper) port)
405 ;; adobe note 5002: should initialize variables before loading routines.
406 (display (procset "music-drawing-routines.ps") port)
407 (display (procset "lilyponddefs.ps") port)
408 (display "%%EndProlog\n" port)
409 (display "%%BeginSetup\ninit-lilypond-parameters\n%%EndSetup\n\n" port))
411 (define-public (output-framework basename book scopes fields)
412 (let* ((filename (format "~a.ps" basename))
413 (outputter (ly:make-paper-outputter
414 ;; FIXME: better wrap open/open-file,
415 ;; content-mangling is always bad.
416 ;; MINGW hack: need to have "b"inary for embedding CFFs
417 (open-file filename "wb")
419 (paper (ly:paper-book-paper book))
420 (systems (ly:paper-book-systems book))
421 (page-stencils (map page-stencil (ly:paper-book-pages book)))
423 (landscape? (eq? (ly:output-def-lookup paper 'landscape) #t))
424 (page-number (1- (ly:output-def-lookup paper 'first-page-number)))
425 (page-count (length page-stencils))
426 (port (ly:outputter-port outputter)))
429 (if (ly:get-option 'clip-systems)
430 (clip-system-EPSes basename book))
432 (if (ly:get-option 'dump-signatures)
433 (write-system-signatures basename (ly:paper-book-systems book) 1))
435 (output-scopes scopes fields basename)
436 (display (file-header paper page-count #t) port)
438 ;; don't do BeginDefaults PageMedia: A4
439 ;; not necessary and wrong
441 (write-preamble paper #t port)
445 (set! page-number (1+ page-number))
446 (dump-page outputter page page-number page-count landscape?))
449 (display "%%Trailer\n%%EOF\n" port)
450 (ly:outputter-close outputter)
451 (postprocess-output book framework-ps-module filename
452 (ly:output-formats))))
454 (define-public (dump-stencil-as-EPS paper dump-me filename
458 ((xext (ly:stencil-extent dump-me X))
459 (yext (ly:stencil-extent dump-me Y))
460 (padding (ly:get-option 'eps-box-padding))
461 (left-overshoot (if (number? padding)
462 (* -1 padding (ly:output-def-lookup paper 'mm))
467 (if (or (nan? x) (inf? x)
469 (equal? (format #f "~S" x) "+#.#")
470 (equal? (format #f "~S" x) "-#.#"))
473 ;; the left-overshoot is to make sure that
474 ;; bar numbers stick out of margin uniformly.
478 (if (number? left-overshoot)
479 (min left-overshoot (car xext))
481 (car yext) (cdr xext) (cdr yext)))))
483 (dump-stencil-as-EPS-with-bbox paper dump-me filename load-fonts bbox)
487 (define-public (dump-stencil-as-EPS-with-bbox paper dump-me filename
490 "Create an EPS file from stencil DUMP-ME to FILENAME. BBOX has format
491 (left-x, lower-y, right x, up-y). If LOAD-FONTS set, include fonts inline."
493 (define (to-rounded-bp-box box)
494 "Convert box to 1/72 inch with rounding to enlarge the box."
495 (let* ((scale (ly:output-def-lookup paper 'output-scale))
496 (strip-non-number (lambda (x)
497 (if (or (nan? x) (inf? x)) 0.0 x)))
498 (directed-round (lambda (x rounder)
500 (rounder (/ (* (strip-non-number x) scale)
502 (list (directed-round (car box) floor)
503 (directed-round (cadr box) floor)
504 (directed-round (max (1+ (car box)) (caddr box)) ceiling)
505 (directed-round (max (1+ (cadr box)) (cadddr box)) ceiling)
508 (let* ((outputter (ly:make-paper-outputter
509 ;; FIXME: better wrap open/open-file,
510 ;; content-mangling is always bad.
511 ;; MINGW hack: need to have "b"inary for embedding CFFs
512 (open-file (format "~a.eps" filename) "wb")
515 (port (ly:outputter-port outputter))
516 (rounded-bbox (to-rounded-bp-box bbox))
517 (port (ly:outputter-port outputter))
518 (header (eps-header paper rounded-bbox load-fonts)))
520 (display header port)
521 (write-preamble paper load-fonts port)
522 (display "gsave set-ps-scale-to-lily-scale\n" port)
523 (ly:outputter-dump-stencil outputter dump-me)
524 (display "stroke grestore\n%%Trailer\n%%EOF\n" port)
525 (ly:outputter-close outputter)))
529 (define (clip-systems-to-region
530 basename paper systems region
534 ((extents-system-pairs
536 (lambda (paper-system)
538 ((x-ext (system-clipped-x-extent
539 (paper-system-system-grob paper-system)
543 (cons x-ext paper-system)
550 (lambda (ext-system-pair)
552 ((xext (car ext-system-pair))
553 (paper-system (cdr ext-system-pair))
554 (yext (paper-system-extent paper-system Y))
555 (bbox (list (car xext) (car yext)
556 (cdr xext) (cdr yext)))
557 (filename (if (< 0 count)
558 (format "~a-~a" basename count)
561 (set! count (1+ count))
562 (dump-stencil-as-EPS-with-bbox
564 (paper-system-stencil paper-system)
566 (ly:get-option 'include-eps-fonts)
570 (postscript->pdf 0 0 (format "~a.eps" filename)))
573 extents-system-pairs)
577 (define-public (clip-system-EPSes basename paper-book)
578 (define do-pdf (member "pdf" (ly:output-formats)))
580 (define (clip-score-systems basename systems)
582 ((layout (ly:grob-layout (paper-system-system-grob (car systems))))
583 (regions (ly:output-def-lookup layout 'clip-regions)))
587 (clip-systems-to-region
588 (format "~a-from-~a-to-~a-clip"
590 (rhythmic-location->file-string (car region))
591 (rhythmic-location->file-string (cdr region)))
592 layout systems region
598 ;; partition in system lists sharing their layout blocks
600 ((systems (ly:paper-book-systems paper-book))
602 (score-system-list '()))
605 (lambda (system last-system)
608 (if (not (and last-system
609 (equal? (paper-system-layout last-system)
610 (paper-system-layout system))))
611 (set! score-system-list (cons '() score-system-list)))
613 (if (paper-system-layout system)
614 (set-car! score-system-list (cons system (car score-system-list))))
623 (lambda (system-list)
626 (format "~a-~a" basename count)
633 (define-public (output-preview-framework basename book scopes fields)
634 (let* ((paper (ly:paper-book-paper book))
635 (systems (ly:paper-book-systems book))
636 (scale (ly:output-def-lookup paper 'output-scale))
637 (to-dump-systems '()))
641 (not (ly:get-option 'include-book-title-preview))
643 (ly:prob-property (car systems) 'is-book-title #f))
645 (set! systems (cdr systems)))
650 (paper-system-title? sys)
651 (not (pair? to-dump-systems))
652 (paper-system-title? (car to-dump-systems)))
653 (set! to-dump-systems (cons sys to-dump-systems))))
658 (stack-stencils Y DOWN 0.0
659 (map paper-system-stencil (reverse to-dump-systems)))
660 (format "~a.preview" basename)
663 (postprocess-output book framework-ps-module
664 (format "~a.preview.eps" basename)
665 (cons "png" (ly:output-formats)))))
668 (define-public (output-preview-framework basename book scopes fields)
670 (let* ((paper (ly:paper-book-paper book))
671 (systems (ly:paper-book-systems book))
672 (scale (ly:output-def-lookup paper 'output-scale))
673 (titles (take-while paper-system-title? systems))
674 (non-title (find (lambda (x)
675 (not (paper-system-title? x))) systems))
677 (stack-stencils Y DOWN 0.0
678 (map paper-system-stencil
679 (append titles (list non-title))))))
680 (output-scopes scopes fields basename)
681 (dump-stencil-as-EPS paper dump-me
682 (format "~a.preview" basename)
685 (postprocess-output book framework-ps-module
686 (format "~a.preview.eps" basename)
687 (ly:output-formats)))))
689 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
691 (define-public (convert-to-pdf book name)
692 (let* ((defs (ly:paper-book-paper book))
693 (landscape (ly:output-def-lookup defs 'landscape))
694 (output-scale (ly:output-def-lookup defs 'output-scale))
695 (convert (lambda (x) (* x output-scale (/ (ly:bp 1)))))
697 (paper-width (convert (ly:output-def-lookup defs 'paper-width)))
698 (paper-height (convert (ly:output-def-lookup defs 'paper-height)))
700 (w (if landscape paper-height paper-width))
701 (h (if landscape paper-width paper-height))
704 (if (equal? (basename name ".ps") "-")
705 (ly:warning (_ "cannot convert <stdout> to ~S" "PDF"))
706 (postscript->pdf w h name))))
708 (define-public (convert-to-png book name)
709 (let* ((defs (ly:paper-book-paper book))
710 (defs-resolution (ly:output-def-lookup defs 'pngresolution))
711 (resolution (if (number? defs-resolution)
713 (ly:get-option 'resolution)))
714 (paper-width (ly:output-def-lookup defs 'paper-width))
715 (paper-height (ly:output-def-lookup defs 'paper-height))
716 (output-scale (ly:output-def-lookup defs 'output-scale)))
718 (postscript->png resolution
719 (* paper-width output-scale (/ (ly:bp 1)))
720 (* paper-height output-scale (/ (ly:bp 1)))
723 (define-public (convert-to-ps book name)
726 (define-public (output-classic-framework basename book scopes fields)
728 (ly:error (_ "\nThe PostScript backend does not support the system-by-system
729 output. For that, use the EPS backend instead,
731 lilypond -dbackend=eps FILE
733 If have cut & pasted a lilypond fragment from a webpage, be sure
734 to only remove anything before
736 %% ****************************************************************
737 %% Start cut-&-pastable-section
738 %% ****************************************************************