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--2008 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 ergonomic-simple-format)
  21
  22 (define framework-ps-module (current-module))
  23
  24 ;;(define pdebug stderr)
  25 (define (pdebug . rest) #f)
  26
  27 (define-public (ps-font-command font)
  28   (let* ((name (ly:font-file-name font))
  29          (magnify (ly:font-magnification font)))
  30     (string-append
  31      "magfont"
  32      (ly:string-substitute
  33       " " "_"
  34       (ly:string-substitute
  35        "/" "_"
  36        (ly:string-substitute
  37         "%" "_" name)))
  38      "m" (string-encode-integer (inexact->exact (round (* 1000 magnify)))))))
  39
  40 (define (define-fonts paper)
  41   (define font-list (ly:paper-fonts paper))
  42
  43   (define (define-font command fontname scaling)
  44     (string-append
  45       "/" command
  46       " { /" fontname
  47       " " (ly:number->string scaling) " output-scale div selectfont }"
  48       " bind def\n"))
  49
  50   (define (font-load-command font)
  51     (let* ((specced-font-name (ly:font-name font))
  52            (fontname (if specced-font-name
  53                          specced-font-name
  54                          (ly:font-file-name font)))
  55            (command (ps-font-command font))
  56
  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)))
  66
  67   (apply string-append
  68          (map (lambda (x) (font-load-command x))
  69               (filter (lambda (x) (not (ly:pango-font? x)))
  70                       font-list))))
  71
  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)
  77     (cond
  78      ((string? val) (string-append "(" val ")"))
  79      ((symbol? val) (symbol->string val))
  80      ((number? val) (number->string val))
  81      (else "")))
  82
  83   (define (output-entry ps-key ly-key)
  84     (string-append
  85      "/" ps-key " "
  86      (value->string (ly:output-def-lookup layout ly-key)) " def\n"))
  87
  88   (string-append
  89    "/lily-output-units "
  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.
  95    "/output-scale "
  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)))
  99
 100 (define (dump-page outputter page page-number page-count landscape?)
 101   (ly:outputter-dump-string
 102    outputter
 103    (string-append
 104     (format "%%Page: ~a ~a\n" page-number page-number)
 105     "%%BeginPageSetup\n"
 106     (if landscape?
 107         "page-width output-scale lily-output-units mul mul 0 translate 90 rotate\n"
 108         "")
 109     "%%EndPageSetup\n"
 110     "\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"))
 115
 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))))
 121
 122   (let* ((fonts (ly:paper-fonts paper))
 123          (names (apply append (map extract-names fonts))))
 124     (apply string-append
 125            (map (lambda (f)
 126                   (format
 127                    (if load-fonts?
 128                        "%%DocumentSuppliedResources: font ~a\n"
 129                        "%%DocumentNeededResources: font ~a\n")
 130                    f))
 131                 (uniq-list (sort names string<?))))))
 132
 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"
 136                  "%%BoundingBox: "
 137                    (string-join (map ly:number->string bbox) " ") "\n"
 138                  "%%Orientation: "
 139                    (if (eq? (ly:output-def-lookup paper 'landscape) #t)
 140                        "Landscape\n"
 141                        "Portrait\n")
 142                  (supplies-or-needs paper load-fonts?)
 143                  "%%EndComments\n"))
 144
 145 (define (ps-document-media paper)
 146   (let* ((w (/ (*
 147                 (ly:output-def-lookup paper 'output-scale)
 148                 (ly:output-def-lookup paper 'paper-width)) (ly:bp 1)))
 149          (h (/ (*
 150                 (ly:output-def-lookup paper 'paper-height)
 151                 (ly:output-def-lookup paper 'output-scale))
 152                (ly:bp 1)))
 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)
 156                (if landscape? h w)
 157                (if landscape? w h)
 158                80   ;; weight
 159                "()" ;; color
 160                "()" ;; type
 161     )))
 162
 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"
 168                  "%%Orientation: "
 169                    (if (eq? (ly:output-def-lookup paper 'landscape) #t)
 170                        "Landscape\n"
 171                        "Portrait\n")
 172                  (ps-document-media paper)
 173                  (supplies-or-needs paper load-fonts?)
 174                  "%%EndComments\n"))
 175
 176 (define (procset file-name)
 177   (format
 178    "%%BeginResource: procset (~a) 1 0
 179 ~a
 180 %%EndResource
 181 "
 182    file-name (cached-file-contents file-name)))
 183
 184 (define (embed-document file-name)
 185   (format "%%BeginDocument: ~a
 186 ~a
 187 %%EndDocument
 188 "
 189    file-name (cached-file-contents file-name)))
 190
 191 (define (setup-variables paper)
 192   (string-append
 193    "\n"
 194    (define-fonts paper)
 195    (output-variables paper)))
 196
 197 (define (cff-font? font)
 198   (let* ((cff-string (ly:otf-font-table-data font "CFF ")))
 199     (> (string-length cff-string) 0)))
 200
 201 (define-public (ps-embed-cff body font-set-name version)
 202   (let* ((binary-data
 203           (string-append
 204            (format "/~a ~s StartData " font-set-name (string-length body))
 205            body))
 206          (header
 207           (format
 208            "%%BeginResource: font ~a
 209 %!PS-Adobe-3.0 Resource-FontSet
 210 %%DocumentNeededResources: ProcSet (FontSetInit)
 211 %%Title: (FontSet/~a)
 212 %%Version: ~s
 213 %%EndComments
 214 %%IncludeResource: ProcSet (FontSetInit)
 215 %%BeginResource: FontSet (~a)
 216 /FontSetInit /ProcSet findresource begin
 217 %%BeginData: ~s Binary Bytes
 218 "
 219            font-set-name font-set-name version font-set-name
 220            (string-length binary-data)))
 221          (footer "\n%%EndData
 222 %%EndResource
 223 %%EndResource\n"))
 224     (string-append header
 225                    binary-data
 226                    footer)))
 227
 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")))
 234
 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))
 239               (begin
 240                 (set! file-name (ly:string-substitute (ly:get-option 'datadir)
 241                                                       "" file-name))
 242                 (format
 243                  "lilypond-datadir (~a) concatstrings (r) file .loadfont\n"
 244                  file-name))
 245               (format "(~a) (r) file .loadfont\n" file-name))
 246           (format "% cannot find font file: ~a\n" file-name)))
 247
 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)))
 252       (cons name
 253             (if (mac-font? bare-file-name)
 254                 (handle-mac-font name bare-file-name)
 255                 (cond
 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))
 261                  (else
 262                   (ly:warning (_ "cannot embed ~S=~S") name file-name)
 263                   ""))))))
 264
 265   (define (dir-join a b)
 266     (if (equal? a "")
 267         b
 268         (string-append a "/" b)))
 269
 270   (define (dir-listing dir-name)
 271     (define (dir-helper dir lst)
 272       (let ((e (readdir dir)))
 273         (if (eof-object? e)
 274             lst
 275             (dir-helper dir (cons e lst)))))
 276     (reverse (dir-helper (opendir dir-name) '())))
 277
 278   (define (handle-mac-font name filename)
 279     (let* ((dir-name (tmpnam))
 280            (files '())
 281            (status 0)
 282            (embed #f))
 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))
 287       (for-each
 288        (lambda (f)
 289          (let* ((full-name (dir-join dir-name f)))
 290            (if (and (not embed)
 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)
 295                    (equal? ".." f))
 296                #t
 297                (delete-file full-name))))
 298        files)
 299       (rmdir dir-name)
 300       (if (not embed)
 301           (begin
 302             (set! embed "% failed\n")
 303             (ly:warning (_ "cannot extract file matching ~a from ~a")
 304                         name filename)))
 305       embed))
 306
 307   (define (font-file-as-ps-string name file-name font-index)
 308     (let* ((downcase-file-name (string-downcase file-name)))
 309       (cond
 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))
 320        (else
 321         (ly:warning (_ "do not know how to embed ~S=~S") name file-name)
 322         ""))))
 323
 324   (define (mac-font? bare-file-name)
 325     (and (eq? PLATFORM 'darwin)
 326          bare-file-name
 327          (or (string-endswith bare-file-name ".dfont")
 328              (= (stat:size (stat bare-file-name)) 0))))
 329
 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)))
 336       (cons 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 ")
 341                                  name
 342                                  0))
 343                   (bare-file-name (font-file-as-ps-string
 344                                    name bare-file-name font-index))
 345                   (else
 346                    (ly:warning (_ "do not know how to embed font ~s ~s ~s")
 347                                name file-name font))))))
 348
 349   (define (load-fonts paper)
 350     (let* ((fonts (ly:paper-fonts paper))
 351
 352            ;; todo - doc format of list.
 353            (all-font-names
 354             (map
 355              (lambda (font)
 356                (cond ((string? (ly:font-file-name font))
 357                       (list (list font
 358                                   (ly:font-name font)
 359                                   (ly:font-file-name font)
 360                                   #f)))
 361                      ((ly:pango-font? font)
 362                       (map (lambda (psname-filename-fontindex)
 363                              (list #f
 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)))
 368                      (else
 369                       (ly:font-sub-fonts font))))
 370              fonts))
 371            (font-names (uniq-list
 372                         (sort (apply append all-font-names)
 373                               (lambda (x y) (string<? (cadr x) (cadr y))))))
 374
 375            ;; slightly spaghetti-ish: deciding what to load where
 376            ;; is smeared out.
 377            (font-loader
 378             (lambda (name)
 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)
 386                          (load-font name)))
 387                     (else
 388                      (load-font name)))))
 389            (pfas (map font-loader font-names)))
 390       pfas))
 391
 392   (display "%%BeginProlog\n" port)
 393   (format
 394    port
 395    "/lilypond-datadir where {pop} {userdict /lilypond-datadir (~a) put } ifelse"
 396    (ly:get-option 'datadir))
 397   (if load-fonts?
 398       (for-each (lambda (f)
 399                   (format port "\n%%BeginFont: ~a\n" (car f))
 400                   (display (cdr f) port)
 401                   (display "%%EndFont\n" port))
 402                 (load-fonts paper)))
 403   (display (setup-variables paper) port)
 404
 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))
 410
 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")
 418                      'ps))
 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)))
 422
 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)))
 427
 428
 429     (if (ly:get-option 'clip-systems)
 430         (clip-system-EPSes basename book))
 431
 432     (if (ly:get-option 'dump-signatures)
 433         (write-system-signatures basename (ly:paper-book-systems book) 1))
 434
 435     (output-scopes scopes fields basename)
 436     (display (file-header paper page-count #t) port)
 437
 438     ;; don't do BeginDefaults PageMedia: A4
 439     ;; not necessary and wrong
 440
 441     (write-preamble paper #t port)
 442
 443     (for-each
 444      (lambda (page)
 445        (set! page-number (1+ page-number))
 446        (dump-page outputter page page-number page-count landscape?))
 447      page-stencils)
 448
 449     (display "%%Trailer\n%%EOF\n" port)
 450     (ly:outputter-close outputter)
 451     (postprocess-output book framework-ps-module filename
 452                          (ly:output-formats))))
 453
 454 (define-public (dump-stencil-as-EPS paper dump-me filename
 455                                     load-fonts)
 456
 457   (let*
 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))
 463                            #f))
 464        (bbox
 465         (map
 466          (lambda (x)
 467            (if (or (nan? x) (inf? x)
 468                      ;; FIXME: huh?
 469                    (equal? (format #f "~S" x) "+#.#")
 470                    (equal? (format #f "~S" x) "-#.#"))
 471                0.0 x))
 472
 473            ;; the left-overshoot is to make sure that
 474            ;; bar numbers stick out of margin uniformly.
 475            ;;
 476            (list
 477
 478             (if (number? left-overshoot)
 479                 (min left-overshoot (car xext))
 480                 (car xext))
 481             (car yext) (cdr xext) (cdr yext)))))
 482
 483        (dump-stencil-as-EPS-with-bbox paper dump-me filename load-fonts bbox)
 484        ))
 485
 486
 487 (define-public (dump-stencil-as-EPS-with-bbox paper dump-me filename
 488                                               load-fonts
 489                                               bbox)
 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."
 492
 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)
 499                              (inexact->exact
 500                               (rounder (/ (* (strip-non-number x) scale)
 501                                           (ly:bp 1)))))))
 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)
 506           )))
 507
 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")
 513                      'ps))
 514
 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)))
 519
 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)))
 526
 527
 528
 529 (define (clip-systems-to-region
 530          basename paper systems region
 531          do-pdf)
 532
 533   (let*
 534       ((extents-system-pairs
 535         (filtered-map
 536          (lambda (paper-system)
 537            (let*
 538                ((x-ext (system-clipped-x-extent
 539                         (paper-system-system-grob paper-system)
 540                         region)))
 541
 542              (if x-ext
 543                  (cons x-ext paper-system)
 544                  #f)))
 545
 546          systems))
 547        (count 0))
 548
 549     (for-each
 550      (lambda (ext-system-pair)
 551        (let*
 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)
 559                           basename)))
 560
 561          (set! count (1+ count))
 562          (dump-stencil-as-EPS-with-bbox
 563           paper
 564           (paper-system-stencil paper-system)
 565           filename
 566           (ly:get-option 'include-eps-fonts)
 567           bbox)
 568
 569          (if do-pdf
 570              (postscript->pdf 0 0 (format "~a.eps" filename)))
 571          ))
 572
 573      extents-system-pairs)
 574     ))
 575
 576
 577 (define-public (clip-system-EPSes basename paper-book)
 578   (define do-pdf (member "pdf" (ly:output-formats)))
 579
 580   (define (clip-score-systems basename systems)
 581     (let*
 582         ((layout (ly:grob-layout (paper-system-system-grob (car systems))))
 583          (regions (ly:output-def-lookup layout 'clip-regions)))
 584
 585       (for-each
 586        (lambda (region)
 587          (clip-systems-to-region
 588           (format "~a-from-~a-to-~a-clip"
 589                   basename
 590                   (rhythmic-location->file-string (car region))
 591                   (rhythmic-location->file-string (cdr region)))
 592           layout systems region
 593           do-pdf))
 594
 595        regions)))
 596
 597
 598   ;; partition in system lists sharing their layout blocks
 599   (let*
 600       ((systems (ly:paper-book-systems paper-book))
 601        (count 0)
 602        (score-system-list '()))
 603
 604     (fold
 605      (lambda (system last-system)
 606
 607
 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)))
 612
 613        (if (paper-system-layout system)
 614            (set-car! score-system-list (cons system (car score-system-list))))
 615
 616        ;; pass value.
 617        system)
 618
 619      #f
 620      systems)
 621
 622     (for-each
 623      (lambda (system-list)
 624        (clip-score-systems
 625         (if (> count 0)
 626             (format "~a-~a" basename count)
 627             basename)
 628         system-list))
 629
 630      score-system-list)))
 631
 632
 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 '()))
 638
 639     ;; skip booktitles.
 640     (if (and
 641          (not (ly:get-option 'include-book-title-preview))
 642          (pair? systems)
 643          (ly:prob-property (car systems) 'is-book-title #f))
 644
 645         (set! systems (cdr systems)))
 646
 647     (for-each
 648      (lambda (sys)
 649        (if (or
 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))))
 654      systems)
 655
 656     (dump-stencil-as-EPS
 657      paper
 658      (stack-stencils Y DOWN 0.0
 659                      (map paper-system-stencil (reverse to-dump-systems)))
 660      (format "~a.preview" basename)
 661      #t)
 662
 663     (postprocess-output book framework-ps-module
 664                         (format "~a.preview.eps" basename)
 665                         (cons "png" (ly:output-formats)))))
 666
 667 (if #f
 668     (define-public (output-preview-framework basename book scopes fields)
 669
 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))
 676              (dump-me
 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)
 683                              #t)
 684
 685         (postprocess-output book framework-ps-module
 686                             (format "~a.preview.eps" basename)
 687                              (ly:output-formats)))))
 688
 689 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 690
 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)))))
 696
 697          (paper-width (convert (ly:output-def-lookup defs 'paper-width)))
 698          (paper-height (convert (ly:output-def-lookup defs 'paper-height)))
 699
 700          (w (if landscape paper-height paper-width))
 701          (h (if landscape paper-width paper-height))
 702          )
 703
 704     (if (equal? (basename name ".ps") "-")
 705         (ly:warning (_ "cannot convert <stdout> to ~S" "PDF"))
 706         (postscript->pdf w h name))))
 707
 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)
 712                          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)))
 717
 718     (postscript->png resolution
 719                      (* paper-width output-scale (/ (ly:bp 1)))
 720                      (* paper-height output-scale (/ (ly:bp 1)))
 721                      name)))
 722
 723 (define-public (convert-to-ps book name)
 724   #t)
 725
 726 (define-public (output-classic-framework basename book scopes fields)
 727
 728   (ly:error (_ "\nThe PostScript backend does not support the system-by-system
 729 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 ")))