]> git.donarmstrong.com Git - lilypond.git/blob - scm/framework-ps.scm
Merge branch 'master' into translation
[lilypond.git] / scm / framework-ps.scm
1 ;;;; This file is part of LilyPond, the GNU music typesetter.
2 ;;;;
3 ;;;; Copyright (C) 2004--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
4 ;;;;
5 ;;;; LilyPond is free software: you can redistribute it and/or modify
6 ;;;; it under the terms of the GNU General Public License as published by
7 ;;;; the Free Software Foundation, either version 3 of the License, or
8 ;;;; (at your option) any later version.
9 ;;;;
10 ;;;; LilyPond is distributed in the hope that it will be useful,
11 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
12 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 ;;;; GNU General Public License for more details.
14 ;;;;
15 ;;;; You should have received a copy of the GNU General Public License
16 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
17
18 (define-module (scm framework-ps))
19
20 ;;; this is still too big a mess.
21
22 (use-modules (ice-9 string-fun)
23              (guile)
24              (scm page)
25              (scm paper-system)
26              (srfi srfi-1)
27              (srfi srfi-13)
28              (scm clip-region)
29              (lily))
30
31 (define format ergonomic-simple-format)
32
33 (define framework-ps-module (current-module))
34
35 ;;(define pdebug stderr)
36 (define (pdebug . rest) #f)
37
38 (define-public (ps-font-command font)
39   (let* ((name (ly:font-file-name font))
40          (magnify (ly:font-magnification font)))
41     (string-append
42      "magfont"
43      (ly:string-substitute
44       " " "_"
45       (ly:string-substitute
46        "/" "_"
47        (ly:string-substitute
48         "%" "_" name)))
49      "m" (string-encode-integer (inexact->exact (round (* 1000 magnify)))))))
50
51 (define (ps-define-pango-pf pango-pf font-name scaling)
52   "")
53
54 (define (ps-define-font font font-name scaling)
55   (if (ly:bigpdfs)
56       (string-append
57        "/" (ps-font-command font) "-N"
58        " { /" font-name "-N"
59        " " (ly:number->string scaling) " output-scale div selectfont }"
60        " bind def\n"
61        "/" (ps-font-command font) "-S"
62        " { /" font-name "-S"
63        " " (ly:number->string scaling) " output-scale div selectfont }"
64        " bind def\n"
65        "/" (ps-font-command font) "-O"
66        " { /" font-name "-O"
67        " " (ly:number->string scaling) " output-scale div selectfont }"
68        " bind def\n"
69        "/help" font-name " {\n  gsave\n  1 setgray\n  /"
70        font-name "-N"
71        " 0.001 selectfont 0 0 moveto <01> show\n  /"
72        font-name "-S"
73        " 0.001 selectfont 0 0 moveto <01> show\n  /"
74        font-name "-O"
75        " 0.001 selectfont 0 0 moveto <01> show\n  grestore\n} def\n")
76       (string-append
77        "/" (ps-font-command font)
78        " { /" font-name
79        " " (ly:number->string scaling) " output-scale div selectfont }"
80        " bind def\n")))
81
82 ;; FIXME: duplicated in other output backends
83 ;; FIXME: silly interface name
84 (define (output-variables layout)
85   ;; FIXME: duplicates output-layout's scope-entry->string, mostly
86   (define (value->string val)
87     (cond
88      ((string? val) (string-append "(" val ")"))
89      ((symbol? val) (symbol->string val))
90      ((number? val) (number->string val))
91      (else "")))
92
93   (define (output-entry ps-key ly-key)
94     (string-append
95      "/" ps-key " "
96      (value->string (ly:output-def-lookup layout ly-key)) " def\n"))
97
98   (string-append
99    "/lily-output-units "
100    (number->string (/ (ly:bp 1))) " def %% millimeter\n"
101    (output-entry "staff-line-thickness" 'line-thickness)
102    (output-entry "line-width" 'line-width)
103    (output-entry "paper-size" 'papersizename)
104    (output-entry "staff-height" 'staff-height)  ;junkme.
105    "/output-scale "
106    (number->string (ly:output-def-lookup layout 'output-scale)) " def\n"
107    (output-entry "page-height" 'paper-height)
108    (output-entry "page-width" 'paper-width)
109    (if (ly:get-option 'strokeadjust) "true setstrokeadjust\n" "")
110    ))
111
112 (define (dump-page outputter page page-number page-count landscape?)
113   (ly:outputter-dump-string
114    outputter
115    (string-append
116     (format #f "%%Page: ~a ~a\n" page-number page-number)
117     "%%BeginPageSetup\n"
118     (if landscape?
119         "page-width output-scale lily-output-units mul mul 0 translate 90 rotate\n"
120         "")
121     "%%EndPageSetup\n"
122     "\n"
123     "gsave 0 paper-height translate set-ps-scale-to-lily-scale\n"
124     "/helpEmmentaler-Brace where {pop helpEmmentaler-Brace} if\n"
125     "/helpEmmentaler-11 where {pop helpEmmentaler-11} if\n"
126     "/helpEmmentaler-13 where {pop helpEmmentaler-13} if\n"
127     "/helpEmmentaler-14 where {pop helpEmmentaler-14} if\n"
128     "/helpEmmentaler-16 where {pop helpEmmentaler-16} if\n"
129     "/helpEmmentaler-18 where {pop helpEmmentaler-18} if\n"
130     "/helpEmmentaler-20 where {pop helpEmmentaler-20} if\n"
131     "/helpEmmentaler-23 where {pop helpEmmentaler-23} if\n"
132     "/helpEmmentaler-26 where {pop helpEmmentaler-26} if\n"))
133   (ly:outputter-dump-stencil outputter page)
134   (ly:outputter-dump-string outputter "stroke grestore\nshowpage\n"))
135
136 (define (supplies-or-needs paper load-fonts?)
137   (define (extract-names font)
138     (if (ly:pango-font? font)
139         (map car (ly:pango-font-physical-fonts font))
140         (list (ly:font-name font))))
141
142   (let* ((fonts (ly:paper-fonts paper))
143          (names (append-map extract-names fonts)))
144     (string-concatenate
145      (map (lambda (f)
146             (format #f
147                     (if load-fonts?
148                         "%%DocumentSuppliedResources: font ~a\n"
149                         "%%DocumentNeededResources: font ~a\n")
150                     f))
151           (uniq-list (sort names string<?))))))
152
153 (define (eps-header paper bbox load-fonts?)
154   (string-append "%!PS-Adobe-2.0 EPSF-2.0\n"
155                  "%%Creator: LilyPond " (lilypond-version) "\n"
156                  "%%BoundingBox: "
157                  (string-join (map ly:number->string bbox) " ") "\n"
158                  "%%Orientation: "
159                  (if (eq? (ly:output-def-lookup paper 'landscape) #t)
160                      "Landscape\n"
161                      "Portrait\n")
162                  (supplies-or-needs paper load-fonts?)
163                  "%%EndComments\n"))
164
165 (define (ps-document-media paper)
166   (let* ((w (/ (*
167                 (ly:output-def-lookup paper 'output-scale)
168                 (ly:output-def-lookup paper 'paper-width)) (ly:bp 1)))
169          (h (/ (*
170                 (ly:output-def-lookup paper 'paper-height)
171                 (ly:output-def-lookup paper 'output-scale))
172                (ly:bp 1)))
173          (landscape? (eq? (ly:output-def-lookup paper 'landscape) #t)))
174     (ly:format "%%DocumentMedia: ~a ~2f ~2f ~a ~a ~a\n"
175                (ly:output-def-lookup paper 'papersizename)
176                (if landscape? h w)
177                (if landscape? w h)
178                80   ;; weight
179                "()" ;; color
180                "()" ;; type
181                )))
182
183 (define (file-header paper page-count load-fonts?)
184   (string-append "%!PS-Adobe-3.0\n"
185                  "%%Creator: LilyPond " (lilypond-version) "\n"
186                  "%%Pages: " (number->string page-count) "\n"
187                  "%%PageOrder: Ascend\n"
188                  "%%Orientation: "
189                  (if (eq? (ly:output-def-lookup paper 'landscape) #t)
190                      "Landscape\n"
191                      "Portrait\n")
192                  (ps-document-media paper)
193                  (supplies-or-needs paper load-fonts?)
194                  "%%EndComments\n"))
195
196 (define (procset file-name)
197   (format #f
198           "%%BeginResource: procset (~a) 1 0
199 ~a
200 %%EndResource
201 "
202           file-name (cached-file-contents file-name)))
203
204 (define (embed-document file-name)
205   (format #f "%%BeginDocument: ~a
206 ~a
207 %%EndDocument
208 "
209           file-name (cached-file-contents file-name)))
210
211 (define (setup-variables paper)
212   (string-append
213    "\n"
214    (define-fonts paper ps-define-font ps-define-pango-pf)
215    (output-variables paper)))
216
217 (define (cff-font? font)
218   (let* ((cff-string (ly:otf-font-table-data font "CFF ")))
219     (> (string-length cff-string) 0)))
220
221 (define-public (ps-embed-cff body font-set-name version)
222   (let* ((binary-data
223           (string-append
224            (format #f "/~a ~s StartData " font-set-name (string-length body))
225            body))
226          (header
227           (format #f
228                   "%%BeginResource: font ~a
229 %!PS-Adobe-3.0 Resource-FontSet
230 %%DocumentNeededResources: ProcSet (FontSetInit)
231 %%Title: (FontSet/~a)
232 %%Version: ~s
233 %%EndComments
234 %%IncludeResource: ProcSet (FontSetInit)
235 %%BeginResource: FontSet (~a)
236 /FontSetInit /ProcSet findresource begin
237 %%BeginData: ~s Binary Bytes
238 "
239                   font-set-name font-set-name version font-set-name
240                   (string-length binary-data)))
241          (footer "\n%%EndData
242 %%EndResource
243 %%EndResource\n"))
244     (string-append header
245                    binary-data
246                    footer)))
247
248 (define (write-preamble paper load-fonts? port)
249   (define (internal-font? font-name-filename)
250     (let* ((font (car font-name-filename))
251            (file-name (caddr font-name-filename))
252            (font-file-name (ly:find-file (format #f "~a.otf" file-name))))
253       (and font
254            (cff-font? font)
255            font-file-name
256            (string-contains font-file-name
257                             (ly:get-option 'datadir)))))
258
259   (define (load-font-via-GS font-name-filename)
260     (define (ps-load-file file-name)
261       (if (string? file-name)
262           (if (string-contains file-name (ly:get-option 'datadir))
263               (begin
264                 (set! file-name (ly:string-substitute (ly:get-option 'datadir)
265                                                       "" file-name))
266                 (format #f
267                         "lilypond-datadir (~a) concatstrings (r) file .loadfont\n"
268                         file-name))
269               (format #f "(~a) (r) file .loadfont\n" file-name))
270           (format #f "% cannot find font file: ~a\n" file-name)))
271
272     (let* ((font (car font-name-filename))
273            (name (cadr font-name-filename))
274            (file-name (caddr font-name-filename))
275            (bare-file-name (ly:find-file file-name)))
276       (cons name
277             (if (mac-font? bare-file-name)
278                 (handle-mac-font name bare-file-name)
279                 (cond
280                  ((and font (cff-font? font))
281                   (ps-load-file (ly:find-file
282                                  (format #f "~a.otf" file-name))))
283                  ((string? bare-file-name)
284                   (ps-load-file file-name))
285                  (else
286                   (ly:warning (_ "cannot embed ~S=~S") name file-name)
287                   ""))))))
288
289   (define (dir-join a b)
290     (if (equal? a "")
291         b
292         (string-append a "/" b)))
293
294   (define (dir-listing dir-name)
295     (define (dir-helper dir lst)
296       (let ((e (readdir dir)))
297         (if (eof-object? e)
298             lst
299             (dir-helper dir (cons e lst)))))
300     (reverse (dir-helper (opendir dir-name) '())))
301
302   (define (handle-mac-font name file-name)
303     (let* ((dir-name (tmpnam))
304            (files '())
305            (status 0)
306            (embed #f)
307            (cwd (getcwd)))
308       (mkdir dir-name #o700)
309       (chdir dir-name)
310       (set! status (ly:system (list "fondu" "-force" file-name)))
311       (chdir cwd)
312       (set! files (dir-listing dir-name))
313       (for-each
314        (lambda (f)
315          (let* ((full-name (dir-join dir-name f)))
316            (if (and (not embed)
317                     (equal? 'regular (stat:type (stat full-name)))
318                     (equal? name (ly:ttf-ps-name full-name)))
319                (set! embed (font-file-as-ps-string name full-name 0)))
320            (if (or (equal? "." f)
321                    (equal? ".." f))
322                #t
323                (delete-file full-name))))
324        files)
325       (rmdir dir-name)
326       (if (not embed)
327           (begin
328             (set! embed "% failed\n")
329             (ly:warning (_ "cannot extract file matching ~a from ~a")
330                         name file-name)))
331       embed))
332
333   (define (font-file-as-ps-string name file-name font-index)
334     (let* ((downcase-file-name (string-downcase file-name)))
335       (cond
336        ((and file-name (string-endswith downcase-file-name ".pfa"))
337         (embed-document file-name))
338        ((and file-name (string-endswith downcase-file-name ".pfb"))
339         (ly:pfb->pfa file-name))
340        ((and file-name (string-endswith downcase-file-name ".ttf"))
341         (ly:ttf->pfa file-name))
342        ((and file-name (string-endswith downcase-file-name ".ttc"))
343         (ly:ttf->pfa file-name font-index))
344        ((and file-name (string-endswith downcase-file-name ".otf"))
345         (ps-embed-cff (ly:otf->cff file-name) name 0))
346        (else
347         (ly:warning (_ "do not know how to embed ~S=~S") name file-name)
348         ""))))
349
350   (define (mac-font? bare-file-name)
351     (and (eq? PLATFORM 'darwin)
352          bare-file-name
353          (or (string-endswith bare-file-name ".dfont")
354              (= (stat:size (stat bare-file-name)) 0))))
355
356   (define (load-font font-psname-filename-fontindex)
357     (let* ((font (list-ref font-psname-filename-fontindex 0))
358            (name (list-ref font-psname-filename-fontindex 1))
359            (file-name (list-ref font-psname-filename-fontindex 2))
360            (font-index (list-ref font-psname-filename-fontindex 3))
361            (bare-file-name (ly:find-file file-name)))
362       (cons name
363             (cond ((mac-font? bare-file-name)
364                    (handle-mac-font name bare-file-name))
365                   ((and font (cff-font? font))
366                    (ps-embed-cff (ly:otf-font-table-data font "CFF ")
367                                  name
368                                  0))
369                   (bare-file-name (font-file-as-ps-string
370                                    name bare-file-name font-index))
371                   (else
372                    (ly:warning (_ "do not know how to embed font ~s ~s ~s")
373                                name file-name font))))))
374
375   (define (load-fonts paper)
376     (let* ((fonts (ly:paper-fonts paper))
377
378            ;; todo - doc format of list.
379            (all-font-names
380             (map
381              (lambda (font)
382                (cond ((string? (ly:font-file-name font))
383                       (list (list font
384                                   (ly:font-name font)
385                                   (ly:font-file-name font)
386                                   #f)))
387                      ((ly:pango-font? font)
388                       (map (lambda (psname-filename-fontindex)
389                              (list #f
390                                    (list-ref psname-filename-fontindex 0)
391                                    (list-ref psname-filename-fontindex 1)
392                                    (list-ref psname-filename-fontindex 2)))
393                            (ly:pango-font-physical-fonts font)))
394                      (else
395                       (ly:font-sub-fonts font))))
396              fonts))
397            (font-names (uniq-list
398                         (sort (concatenate all-font-names)
399                               (lambda (x y) (string<? (cadr x) (cadr y))))))
400
401            ;; slightly spaghetti-ish: deciding what to load where
402            ;; is smeared out.
403            (font-loader
404             (lambda (name)
405               (cond ((ly:get-option 'gs-load-fonts)
406                      (load-font-via-GS name))
407                     ((ly:get-option 'gs-load-lily-fonts)
408                      (if (or (string-contains (caddr name)
409                                               (ly:get-option 'datadir))
410                              (internal-font? name))
411                          (load-font-via-GS name)
412                          (load-font name)))
413                     (else
414                      (load-font name)))))
415            (pfas (map font-loader font-names)))
416       pfas))
417
418
419   (display "%%BeginProlog\n" port)
420   (format
421    port
422    "/lilypond-datadir where {pop} {userdict /lilypond-datadir (~a) put } ifelse"
423    (ly:get-option 'datadir))
424   (if load-fonts?
425       (for-each (lambda (f)
426                   (format port "\n%%BeginFont: ~a\n" (car f))
427                   (display (cdr f) port)
428                   (display "%%EndFont\n" port))
429                 (load-fonts paper)))
430   (if (ly:bigpdfs)
431       (display (procset "encodingdefs.ps") port))
432   (display (setup-variables paper) port)
433
434   ;; adobe note 5002: should initialize variables before loading routines.
435   (display (procset "music-drawing-routines.ps") port)
436   (display (procset "lilyponddefs.ps") port)
437   (display "%%EndProlog\n" port)
438   (display "%%BeginSetup\ninit-lilypond-parameters\n%%EndSetup\n\n" port))
439
440 (define (ps-quote str)
441   (fold
442    (lambda (replacement-list result)
443      (string-join
444       (string-split
445        result
446        (car replacement-list))
447       (cadr replacement-list)))
448    str
449    '((#\\ "\\\\") (#\( "\\(") (#\) "\\)"))))
450
451 ;;; Create DOCINFO pdfmark containing metadata
452 ;;; header fields with pdf prefix override those without the prefix
453 (define (handle-metadata header port)
454   (define (metadata-encode val)
455     ;; First, call ly:encode-string-for-pdf to encode the string (latin1 or
456     ;; utf-16be), then escape all parentheses and backslashes
457     ;; FIXME guile-2.0: use (string->utf16 str 'big) instead
458
459     (ps-quote (ly:encode-string-for-pdf val)))
460   (define (metadata-lookup-output overridevar fallbackvar field)
461     (let* ((overrideval (ly:modules-lookup (list header) overridevar))
462            (fallbackval (ly:modules-lookup (list header) fallbackvar))
463            (val (if overrideval overrideval fallbackval)))
464       (if val
465           (format port "/~a (~a)\n" field (metadata-encode (markup->string val (list header)))))))
466   (display "[ " port)
467   (metadata-lookup-output 'pdfauthor 'author "Author")
468   (format port "/Creator (LilyPond ~a)\n" (lilypond-version))
469   (metadata-lookup-output 'pdftitle 'title "Title")
470   (metadata-lookup-output 'pdfsubject 'subject "Subject")
471   (metadata-lookup-output 'pdfkeywords 'keywords "Keywords")
472   (metadata-lookup-output 'pdfmodDate 'modDate "ModDate")
473   (metadata-lookup-output 'pdfsubtitle 'subtitle "Subtitle")
474   (metadata-lookup-output 'pdfcomposer 'composer "Composer")
475   (metadata-lookup-output 'pdfarranger 'arranger "Arranger")
476   (metadata-lookup-output 'pdfpoet 'poet "Poet")
477   (metadata-lookup-output 'pdfcopyright 'copyright "Copyright")
478   (display "/DOCINFO pdfmark\n\n" port))
479
480
481 (define-public (output-framework basename book scopes fields)
482   (let* ((port-tmp (make-tmpfile))
483          (tmp-name (port-filename port-tmp))
484          (outputter (ly:make-paper-outputter
485                      port-tmp
486                      'ps))
487          (paper (ly:paper-book-paper book))
488          (header (ly:paper-book-header book))
489          (systems (ly:paper-book-systems book))
490          (page-stencils (map page-stencil (ly:paper-book-pages book)))
491          (landscape? (eq? (ly:output-def-lookup paper 'landscape) #t))
492          (page-number (1- (ly:output-def-lookup paper 'first-page-number)))
493          (page-count (length page-stencils))
494          (port (ly:outputter-port outputter)))
495     (if (ly:get-option 'clip-systems)
496         (clip-system-EPSes basename book))
497     (if (ly:get-option 'dump-signatures)
498         (write-system-signatures basename (ly:paper-book-systems book) 1))
499     (output-scopes scopes fields basename)
500     (display (file-header paper page-count #t) port)
501     ;; don't do BeginDefaults PageMedia: A4
502     ;; not necessary and wrong
503     (write-preamble paper #t port)
504     (if (module? header)
505         (handle-metadata header port))
506     (for-each
507      (lambda (page)
508        (set! page-number (1+ page-number))
509        (dump-page outputter page page-number page-count landscape?))
510      page-stencils)
511     (display "%%Trailer\n%%EOF\n" port)
512     (ly:outputter-close outputter)
513     (postprocess-output book framework-ps-module (ly:output-formats)
514                         basename tmp-name #f)))
515
516 (define-public (dump-stencil-as-EPS paper dump-me filename
517                                     load-fonts)
518   (let* ((xext (ly:stencil-extent dump-me X))
519          (yext (ly:stencil-extent dump-me Y))
520          (padding (ly:get-option 'eps-box-padding))
521          (left-overshoot (if (number? padding)
522                              (* -1 padding (ly:output-def-lookup paper 'mm))
523                              #f))
524          (bbox
525           (map
526            (lambda (x)
527              (if (or (nan? x) (inf? x)
528                      ;; FIXME: huh?
529                      (equal? (format #f "~S" x) "+#.#")
530                      (equal? (format #f "~S" x) "-#.#"))
531                  0.0 x))
532
533            ;; the left-overshoot is to make sure that
534            ;; bar numbers stick out of margin uniformly.
535            ;;
536            (list
537             (if (number? left-overshoot)
538                 (min left-overshoot (car xext))
539                 (car xext))
540             (car yext) (cdr xext) (cdr yext)))))
541     (dump-stencil-as-EPS-with-bbox paper dump-me filename load-fonts bbox)))
542
543 (define-public (dump-stencil-as-EPS-with-bbox paper dump-me filename
544                                               load-fonts
545                                               bbox)
546   "Create an EPS file from stencil @var{dump-me} to @var{filename}.
547 @var{bbox} has format @code{(left-x, lower-y, right-x, upper-y)}.  If
548 @var{load-fonts} set, include fonts inline."
549   (define (to-rounded-bp-box box)
550     "Convert box to 1/72 inch with rounding to enlarge the box."
551     (let* ((scale (ly:output-def-lookup paper 'output-scale))
552            (strip-non-number (lambda (x)
553                                (if (or (nan? x)
554                                        (inf? x))
555                                    0.0
556                                    x)))
557            (directed-round (lambda (x rounder)
558                              (inexact->exact
559                               (rounder (/ (* (strip-non-number x) scale)
560                                           (ly:bp 1)))))))
561       (list (directed-round (car box) floor)
562             (directed-round (cadr box) floor)
563             (directed-round (max (1+ (car box)) (caddr box)) ceiling)
564             (directed-round (max (1+ (cadr box)) (cadddr box)) ceiling))))
565
566   (let* ((outputter (ly:make-paper-outputter
567                      ;; FIXME: better wrap open/open-file,
568                      ;; content-mangling is always bad.
569                      ;; MINGW hack: need to have "b"inary for embedding CFFs
570                      (open-file (format #f "~a.eps" filename) "wb")
571                      'ps))
572          (port (ly:outputter-port outputter))
573          (rounded-bbox (to-rounded-bp-box bbox))
574          (port (ly:outputter-port outputter))
575          (header (eps-header paper rounded-bbox load-fonts)))
576     (display header port)
577     (write-preamble paper load-fonts port)
578     (display "/mark_page_link { pop pop pop pop pop } bind def\n" port)
579     (display "gsave set-ps-scale-to-lily-scale\n" port)
580     (display "/helpEmmentaler-Brace where {pop helpEmmentaler-Brace} if\n" port)
581     (display "/helpEmmentaler-11 where {pop helpEmmentaler-11} if\n" port)
582     (display "/helpEmmentaler-13 where {pop helpEmmentaler-13} if\n" port)
583     (display "/helpEmmentaler-14 where {pop helpEmmentaler-14} if\n" port)
584     (display "/helpEmmentaler-16 where {pop helpEmmentaler-16} if\n" port)
585     (display "/helpEmmentaler-18 where {pop helpEmmentaler-18} if\n" port)
586     (display "/helpEmmentaler-20 where {pop helpEmmentaler-20} if\n" port)
587     (display "/helpEmmentaler-23 where {pop helpEmmentaler-23} if\n" port)
588     (display "/helpEmmentaler-26 where {pop helpEmmentaler-26} if\n" port)
589     (ly:outputter-dump-stencil outputter dump-me)
590     (display "stroke grestore\n%%Trailer\n%%EOF\n" port)
591     (ly:outputter-close outputter)))
592
593 (define (clip-systems-to-region basename paper systems region do-pdf do-png)
594   (let* ((extents-system-pairs
595           (filtered-map (lambda (paper-system)
596                           (let* ((x-ext (system-clipped-x-extent
597                                          (paper-system-system-grob paper-system)
598                                          region)))
599                             (if x-ext
600                                 (cons x-ext paper-system)
601                                 #f)))
602                         systems))
603          (count 0))
604     (for-each
605      (lambda (ext-system-pair)
606        (let* ((xext (car ext-system-pair))
607               (paper-system (cdr ext-system-pair))
608               (yext (paper-system-extent paper-system Y))
609               (bbox (list (car xext) (car yext)
610                           (cdr xext) (cdr yext)))
611               (filename (if (< 0 count)
612                             (format #f "~a-~a" basename count)
613                             basename)))
614          (set! count (1+ count))
615          (dump-stencil-as-EPS-with-bbox paper
616                                         (paper-system-stencil paper-system)
617                                         filename
618                                         (ly:get-option 'include-eps-fonts)
619                                         bbox)
620          (if do-pdf
621              (postscript->pdf 0 0 filename (format #f "~a.eps" filename) #t))
622          (if do-png
623              (postscript->png (ly:get-option 'resolution) 0 0
624                               filename (format #f "~a.eps" filename) #t))))
625      extents-system-pairs)))
626
627 (define-public (clip-system-EPSes basename paper-book)
628   (define do-pdf
629     (member "pdf" (ly:output-formats)))
630   (define do-png
631     (member "png" (ly:output-formats)))
632
633   (define (clip-score-systems basename systems)
634     (let* ((layout (ly:grob-layout (paper-system-system-grob (car systems))))
635            (regions (ly:output-def-lookup layout 'clip-regions)))
636       (for-each
637        (lambda (region)
638          (clip-systems-to-region
639           (format #f "~a-from-~a-to-~a-clip"
640                   basename
641                   (rhythmic-location->file-string (car region))
642                   (rhythmic-location->file-string (cdr region)))
643           layout systems region
644           do-pdf do-png))
645        regions)))
646
647   ;; partition in system lists sharing their layout blocks
648   (let* ((systems (ly:paper-book-systems paper-book))
649          (count 0)
650          (score-system-list '()))
651     (fold
652      (lambda (system last-system)
653        (if (not (and last-system
654                      (equal? (paper-system-layout last-system)
655                              (paper-system-layout system))))
656            (set! score-system-list (cons '() score-system-list)))
657        (if (paper-system-layout system)
658            (set-car! score-system-list (cons system (car score-system-list))))
659        ;; pass value.
660        system)
661      #f
662      systems)
663     (for-each (lambda (system-list)
664                 ;; filter out headers and top-level markup
665                 (if (pair? system-list)
666                     (clip-score-systems
667                      (if (> count 0)
668                          (format #f "~a-~a" basename count)
669                          basename)
670                      system-list)))
671               score-system-list)))
672
673 (define-public (output-preview-framework basename book scopes fields)
674   (let* ((paper (ly:paper-book-paper book))
675          (systems (relevant-book-systems book))
676          (to-dump-systems (relevant-dump-systems systems)))
677     (dump-stencil-as-EPS paper
678                          (stack-stencils Y DOWN 0.0
679                                          (map paper-system-stencil
680                                               (reverse to-dump-systems)))
681                          (format #f "~a.preview" basename)
682                          #t)
683     (postprocess-output book framework-ps-module
684                         (cons "png" (ly:output-formats))
685                         (format #f "~a.preview" basename)
686                         (format #f "~a.preview.eps" basename)
687                         #t
688                         )))
689
690 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
691
692 (define (output-width-height defs)
693   (let* ((landscape (ly:output-def-lookup defs 'landscape))
694          (output-scale (ly:output-def-lookup defs 'output-scale))
695          (convert (lambda (x)
696                     (* 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)))
699          (w (if landscape paper-height paper-width))
700          (h (if landscape paper-width paper-height)))
701     (cons w h)))
702
703 (define (output-resolution defs)
704   (let ((defs-resolution (ly:output-def-lookup defs 'pngresolution)))
705     (if (number? defs-resolution)
706         defs-resolution
707         (ly:get-option 'resolution))))
708
709 (define-public (convert-to-pdf book base-name tmp-name is-eps)
710   (let* ((defs (ly:paper-book-paper book))
711          (width-height (output-width-height defs))
712          (width (car width-height))
713          (height (cdr width-height)))
714     (postscript->pdf width height base-name tmp-name is-eps)))
715
716 (define-public (convert-to-png book base-name tmp-name is-eps)
717   (let* ((defs (ly:paper-book-paper book))
718          (resolution (output-resolution defs))
719          (width-height (output-width-height defs))
720          (width (car width-height))
721          (height (cdr width-height)))
722     (postscript->png resolution width height base-name tmp-name is-eps)))
723
724 (define-public (convert-to-ps book base-name tmp-name is-eps)
725   (postscript->ps base-name tmp-name is-eps))
726
727 (define-public (output-classic-framework basename book scopes fields)
728   (ly:error (_ "\nThe PostScript backend does not support the
729 system-by-system output.  For that, use the EPS backend instead,
730
731   lilypond -dbackend=eps FILE
732
733 If have cut & pasted a lilypond fragment from a webpage, be sure
734 to only remove anything before
735
736   %% ****************************************************************
737   %% Start cut-&-pastable-section
738   %% ****************************************************************
739 ")))