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