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         ;; TODO: distinguish files which have extension `*.ttc'
 344         ;; whether TrueType Collection (TTC) fonts
 345         ;; or OpenType/CFF Collection (OTC) fonts.
 346         (ly:ttf->pfa file-name font-index)) ;; TTC fonts
 347        ((and file-name (string-endswith downcase-file-name ".otf"))
 348         (ps-embed-cff (ly:otf->cff file-name) name 0))
 349        ((and file-name (string-endswith downcase-file-name ".otc"))
 350         ;; The files which have the extension `*.otc' are OTC fonts.
 351         (ps-embed-cff (ly:otf->cff file-name font-index) name 0)) ;; OTC fonts
 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 (eq? PLATFORM 'darwin)
 358          bare-file-name
 359          (or (string-endswith bare-file-name ".dfont")
 360              (= (stat:size (stat bare-file-name)) 0))))
 361
 362   (define (load-font font-psname-filename-fontindex)
 363     (let* ((font (list-ref font-psname-filename-fontindex 0))
 364            (name (list-ref font-psname-filename-fontindex 1))
 365            (file-name (list-ref font-psname-filename-fontindex 2))
 366            (font-index (list-ref font-psname-filename-fontindex 3))
 367            (bare-file-name (ly:find-file file-name)))
 368       (cons name
 369             (cond ((mac-font? bare-file-name)
 370                    (handle-mac-font name bare-file-name))
 371                   ((and font (cff-font? font))
 372                    (ps-embed-cff (ly:otf-font-table-data font "CFF ")
 373                                  name
 374                                  0))
 375                   (bare-file-name (font-file-as-ps-string
 376                                    name bare-file-name font-index))
 377                   (else
 378                    (ly:warning (_ "do not know how to embed font ~s ~s ~s")
 379                                name file-name font))))))
 380
 381   (define (load-fonts paper)
 382     (let* ((fonts (ly:paper-fonts paper))
 383
 384            ;; todo - doc format of list.
 385            (all-font-names
 386             (map
 387              (lambda (font)
 388                (cond ((string? (ly:font-file-name font))
 389                       (list (list font
 390                                   (ly:font-name font)
 391                                   (ly:font-file-name font)
 392                                   #f)))
 393                      ((ly:pango-font? font)
 394                       (map (lambda (psname-filename-fontindex)
 395                              (list #f
 396                                    (list-ref psname-filename-fontindex 0)
 397                                    (list-ref psname-filename-fontindex 1)
 398                                    (list-ref psname-filename-fontindex 2)))
 399                            (ly:pango-font-physical-fonts font)))
 400                      (else
 401                       (ly:font-sub-fonts font))))
 402              fonts))
 403            (font-names (uniq-list
 404                         (sort (concatenate all-font-names)
 405                               (lambda (x y) (string<? (cadr x) (cadr y))))))
 406
 407            ;; slightly spaghetti-ish: deciding what to load where
 408            ;; is smeared out.
 409            (font-loader
 410             (lambda (name)
 411               (cond ((ly:get-option 'gs-load-fonts)
 412                      (load-font-via-GS name))
 413                     ((ly:get-option 'gs-load-lily-fonts)
 414                      (if (or (string-contains (caddr name)
 415                                               (ly:get-option 'datadir))
 416                              (internal-font? name))
 417                          (load-font-via-GS name)
 418                          (load-font name)))
 419                     (else
 420                      (load-font name)))))
 421            (pfas (map font-loader font-names)))
 422       pfas))
 423
 424
 425   (display "%%BeginProlog\n" port)
 426   (format
 427    port
 428    "/lilypond-datadir where {pop} {userdict /lilypond-datadir (~a) put } ifelse"
 429    (ly:get-option 'datadir))
 430   (if load-fonts?
 431       (for-each (lambda (f)
 432                   (format port "\n%%BeginFont: ~a\n" (car f))
 433                   (display (cdr f) port)
 434                   (display "%%EndFont\n" port))
 435                 (load-fonts paper)))
 436   (if (ly:bigpdfs)
 437       (display (procset "encodingdefs.ps") port))
 438   (display (setup-variables paper) port)
 439
 440   ;; adobe note 5002: should initialize variables before loading routines.
 441   (display (procset "music-drawing-routines.ps") port)
 442   (display (procset "lilyponddefs.ps") port)
 443   (display "%%EndProlog\n" port)
 444   (display "%%BeginSetup\ninit-lilypond-parameters\n%%EndSetup\n\n" port))
 445
 446 (define (ps-quote str)
 447   (fold
 448    (lambda (replacement-list result)
 449      (string-join
 450       (string-split
 451        result
 452        (car replacement-list))
 453       (cadr replacement-list)))
 454    str
 455    '((#\\ "\\\\") (#\( "\\(") (#\) "\\)"))))
 456
 457 ;;; Create DOCINFO pdfmark containing metadata
 458 ;;; header fields with pdf prefix override those without the prefix
 459 (define (handle-metadata header port)
 460   (define (metadata-encode val)
 461     ;; First, call ly:encode-string-for-pdf to encode the string (latin1 or
 462     ;; utf-16be), then escape all parentheses and backslashes
 463     ;; FIXME guile-2.0: use (string->utf16 str 'big) instead
 464
 465     (ps-quote (ly:encode-string-for-pdf val)))
 466   (define (metadata-lookup-output overridevar fallbackvar field)
 467     (let* ((overrideval (ly:modules-lookup (list header) overridevar))
 468            (fallbackval (ly:modules-lookup (list header) fallbackvar))
 469            (val (if overrideval overrideval fallbackval)))
 470       (if val
 471           (format port "/~a (~a)\n" field (metadata-encode (markup->string val (list header)))))))
 472
 473   (if (module? header)
 474       (begin
 475        (display "mark " port)
 476        (metadata-lookup-output 'pdfauthor 'author "Author")
 477        (format port "/Creator (LilyPond ~a)\n" (lilypond-version))
 478        (metadata-lookup-output 'pdftitle 'title "Title")
 479        (metadata-lookup-output 'pdfsubject 'subject "Subject")
 480        (metadata-lookup-output 'pdfkeywords 'keywords "Keywords")
 481        (metadata-lookup-output 'pdfmodDate 'modDate "ModDate")
 482        (metadata-lookup-output 'pdfsubtitle 'subtitle "Subtitle")
 483        (metadata-lookup-output 'pdfcomposer 'composer "Composer")
 484        (metadata-lookup-output 'pdfarranger 'arranger "Arranger")
 485        (metadata-lookup-output 'pdfpoet 'poet "Poet")
 486        (metadata-lookup-output 'pdfcopyright 'copyright "Copyright")
 487        (display "/DOCINFO pdfmark\n\n" port)))
 488
 489   (if (ly:get-option 'embed-source-code)
 490       (let ((source-list (delete-duplicates
 491                           (remove (lambda (str)
 492                                     (or
 493                                      (string-contains str
 494                                        (ly:get-option 'datadir))
 495                                      (string=? str
 496                                        "<included string>")))
 497                             (ly:source-files)))))
 498          (display "\n/pdfmark where
 499 {pop} {userdict /pdfmark /cleartomark load put} ifelse" port)
 500          (for-each (lambda (fname idx)
 501                      (format port "\n
 502 mark /_objdef {ly~a_stream} /type /stream   /OBJ pdfmark
 503 mark {ly~a_stream} << /Type /EmbeddedFile>> /PUT pdfmark
 504 mark {ly~a_stream} (~a) /PUT pdfmark
 505 mark /Name (LilyPond source file ~a)
 506 /FS << /Type /Filespec /F (~a) /EF << /F {ly~a_stream} >> >> /EMBED pdfmark
 507 mark {ly~a_stream} /CLOSE pdfmark
 508 \n"
 509                 idx idx idx
 510                 (ps-quote (ly:gulp-file fname))
 511                   idx fname idx idx))
 512           source-list (iota (length source-list))))))
 513
 514 (define-public (output-framework basename book scopes fields)
 515   (let* ((port-tmp (make-tmpfile))
 516          (tmp-name (port-filename port-tmp))
 517          (outputter (ly:make-paper-outputter
 518                      port-tmp
 519                      'ps))
 520          (paper (ly:paper-book-paper book))
 521          (header (ly:paper-book-header book))
 522          (systems (ly:paper-book-systems book))
 523          (page-stencils (map page-stencil (ly:paper-book-pages book)))
 524          (landscape? (eq? (ly:output-def-lookup paper 'landscape) #t))
 525          (page-number (1- (ly:output-def-lookup paper 'first-page-number)))
 526          (page-count (length page-stencils))
 527          (port (ly:outputter-port outputter)))
 528     (if (ly:get-option 'clip-systems)
 529         (clip-system-EPSes basename book))
 530     (if (ly:get-option 'dump-signatures)
 531         (write-system-signatures basename (ly:paper-book-systems book) 1))
 532     (output-scopes scopes fields basename)
 533     (display (file-header paper page-count #t) port)
 534     ;; don't do BeginDefaults PageMedia: A4
 535     ;; not necessary and wrong
 536     (write-preamble paper #t port)
 537     (handle-metadata header port)
 538     (for-each
 539      (lambda (page)
 540        (set! page-number (1+ page-number))
 541        (dump-page outputter page page-number page-count landscape?))
 542      page-stencils)
 543     (display "%%Trailer\n%%EOF\n" port)
 544     (ly:outputter-close outputter)
 545     (postprocess-output book framework-ps-module (ly:output-formats)
 546                         basename tmp-name #f)))
 547
 548 (define-public (dump-stencil-as-EPS paper dump-me filename
 549                                     load-fonts)
 550   (let* ((xext (ly:stencil-extent dump-me X))
 551          (yext (ly:stencil-extent dump-me Y))
 552          (padding (ly:get-option 'eps-box-padding))
 553          (left-overshoot (if (number? padding)
 554                              (* -1 padding (ly:output-def-lookup paper 'mm))
 555                              #f))
 556          (bbox
 557           (map
 558            (lambda (x)
 559              (if (or (nan? x) (inf? x)
 560                      ;; FIXME: huh?
 561                      (equal? (format #f "~S" x) "+#.#")
 562                      (equal? (format #f "~S" x) "-#.#"))
 563                  0.0 x))
 564
 565            ;; the left-overshoot is to make sure that
 566            ;; bar numbers stick out of margin uniformly.
 567            ;;
 568            (list
 569             (if (number? left-overshoot)
 570                 (min left-overshoot (car xext))
 571                 (car xext))
 572             (car yext) (cdr xext) (cdr yext)))))
 573     (dump-stencil-as-EPS-with-bbox paper dump-me filename load-fonts bbox)))
 574
 575 (define-public (dump-stencil-as-EPS-with-bbox paper dump-me filename
 576                                               load-fonts
 577                                               bbox)
 578   "Create an EPS file from stencil @var{dump-me} to @var{filename}.
 579 @var{bbox} has format @code{(left-x, lower-y, right-x, upper-y)}.  If
 580 @var{load-fonts} set, include fonts inline."
 581   (define (to-rounded-bp-box box)
 582     "Convert box to 1/72 inch with rounding to enlarge the box."
 583     (let* ((scale (ly:output-def-lookup paper 'output-scale))
 584            (strip-non-number (lambda (x)
 585                                (if (or (nan? x)
 586                                        (inf? x))
 587                                    0.0
 588                                    x)))
 589            (directed-round (lambda (x rounder)
 590                              (inexact->exact
 591                               (rounder (/ (* (strip-non-number x) scale)
 592                                           (ly:bp 1)))))))
 593       (list (directed-round (car box) floor)
 594             (directed-round (cadr box) floor)
 595             (directed-round (max (1+ (car box)) (caddr box)) ceiling)
 596             (directed-round (max (1+ (cadr box)) (cadddr box)) ceiling))))
 597
 598   (let* ((outputter (ly:make-paper-outputter
 599                      ;; FIXME: better wrap open/open-file,
 600                      ;; content-mangling is always bad.
 601                      ;; MINGW hack: need to have "b"inary for embedding CFFs
 602                      (open-file (format #f "~a.eps" filename) "wb")
 603                      'ps))
 604          (port (ly:outputter-port outputter))
 605          (rounded-bbox (to-rounded-bp-box bbox))
 606          (port (ly:outputter-port outputter))
 607          (header (eps-header paper rounded-bbox load-fonts)))
 608     (display header port)
 609     (write-preamble paper load-fonts port)
 610     (display "/mark_page_link { pop pop pop pop pop } bind def\n" port)
 611     (display "gsave set-ps-scale-to-lily-scale\n" port)
 612     (display "/helpEmmentaler-Brace where {pop helpEmmentaler-Brace} if\n" port)
 613     (display "/helpEmmentaler-11 where {pop helpEmmentaler-11} if\n" port)
 614     (display "/helpEmmentaler-13 where {pop helpEmmentaler-13} if\n" port)
 615     (display "/helpEmmentaler-14 where {pop helpEmmentaler-14} if\n" port)
 616     (display "/helpEmmentaler-16 where {pop helpEmmentaler-16} if\n" port)
 617     (display "/helpEmmentaler-18 where {pop helpEmmentaler-18} if\n" port)
 618     (display "/helpEmmentaler-20 where {pop helpEmmentaler-20} if\n" port)
 619     (display "/helpEmmentaler-23 where {pop helpEmmentaler-23} if\n" port)
 620     (display "/helpEmmentaler-26 where {pop helpEmmentaler-26} if\n" port)
 621     (ly:outputter-dump-stencil outputter dump-me)
 622     (display "stroke grestore\n%%Trailer\n%%EOF\n" port)
 623     (ly:outputter-close outputter)))
 624
 625 (define (clip-systems-to-region basename paper systems region do-pdf do-png)
 626   (let* ((extents-system-pairs
 627           (filtered-map (lambda (paper-system)
 628                           (let* ((x-ext (system-clipped-x-extent
 629                                          (paper-system-system-grob paper-system)
 630                                          region)))
 631                             (if x-ext
 632                                 (cons x-ext paper-system)
 633                                 #f)))
 634                         systems))
 635          (count 0))
 636     (for-each
 637      (lambda (ext-system-pair)
 638        (let* ((xext (car ext-system-pair))
 639               (paper-system (cdr ext-system-pair))
 640               (yext (paper-system-extent paper-system Y))
 641               (bbox (list (car xext) (car yext)
 642                           (cdr xext) (cdr yext)))
 643               (filename (if (< 0 count)
 644                             (format #f "~a-~a" basename count)
 645                             basename)))
 646          (set! count (1+ count))
 647          (dump-stencil-as-EPS-with-bbox paper
 648                                         (paper-system-stencil paper-system)
 649                                         filename
 650                                         (ly:get-option 'include-eps-fonts)
 651                                         bbox)
 652          (if do-pdf
 653              (postscript->pdf 0 0 filename (format #f "~a.eps" filename) #t))
 654          (if do-png
 655              (postscript->png (ly:get-option 'resolution) 0 0
 656                               filename (format #f "~a.eps" filename) #t))))
 657      extents-system-pairs)))
 658
 659 (define-public (clip-system-EPSes basename paper-book)
 660   (define do-pdf
 661     (member "pdf" (ly:output-formats)))
 662   (define do-png
 663     (member "png" (ly:output-formats)))
 664
 665   (define (clip-score-systems basename systems)
 666     (let* ((layout (ly:grob-layout (paper-system-system-grob (car systems))))
 667            (regions (ly:output-def-lookup layout 'clip-regions)))
 668       (for-each
 669        (lambda (region)
 670          (clip-systems-to-region
 671           (format #f "~a-from-~a-to-~a-clip"
 672                   basename
 673                   (rhythmic-location->file-string (car region))
 674                   (rhythmic-location->file-string (cdr region)))
 675           layout systems region
 676           do-pdf do-png))
 677        regions)))
 678
 679   ;; partition in system lists sharing their layout blocks
 680   (let* ((systems (ly:paper-book-systems paper-book))
 681          (count 0)
 682          (score-system-list '()))
 683     (fold
 684      (lambda (system last-system)
 685        (if (not (and last-system
 686                      (equal? (paper-system-layout last-system)
 687                              (paper-system-layout system))))
 688            (set! score-system-list (cons '() score-system-list)))
 689        (if (paper-system-layout system)
 690            (set-car! score-system-list (cons system (car score-system-list))))
 691        ;; pass value.
 692        system)
 693      #f
 694      systems)
 695     (for-each (lambda (system-list)
 696                 ;; filter out headers and top-level markup
 697                 (if (pair? system-list)
 698                     (clip-score-systems
 699                      (if (> count 0)
 700                          (format #f "~a-~a" basename count)
 701                          basename)
 702                      system-list)))
 703               score-system-list)))
 704
 705 (define-public (output-preview-framework basename book scopes fields)
 706   (let* ((paper (ly:paper-book-paper book))
 707          (systems (relevant-book-systems book))
 708          (to-dump-systems (relevant-dump-systems systems)))
 709     (dump-stencil-as-EPS paper
 710                          (stack-stencils Y DOWN 0.0
 711                                          (map paper-system-stencil
 712                                               (reverse to-dump-systems)))
 713                          (format #f "~a.preview" basename)
 714                          #t)
 715     (postprocess-output book framework-ps-module
 716                         (cons "png" (ly:output-formats))
 717                         (format #f "~a.preview" basename)
 718                         (format #f "~a.preview.eps" basename)
 719                         #t
 720                         )))
 721
 722 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 723
 724 (define (output-width-height defs)
 725   (let* ((landscape (ly:output-def-lookup defs 'landscape))
 726          (output-scale (ly:output-def-lookup defs 'output-scale))
 727          (convert (lambda (x)
 728                     (* x output-scale (/ (ly:bp 1)))))
 729          (paper-width (convert (ly:output-def-lookup defs 'paper-width)))
 730          (paper-height (convert (ly:output-def-lookup defs 'paper-height)))
 731          (w (if landscape paper-height paper-width))
 732          (h (if landscape paper-width paper-height)))
 733     (cons w h)))
 734
 735 (define (output-resolution defs)
 736   (let ((defs-resolution (ly:output-def-lookup defs 'pngresolution)))
 737     (if (number? defs-resolution)
 738         defs-resolution
 739         (ly:get-option 'resolution))))
 740
 741 (define-public (convert-to-pdf book base-name tmp-name is-eps)
 742   (let* ((defs (ly:paper-book-paper book))
 743          (width-height (output-width-height defs))
 744          (width (car width-height))
 745          (height (cdr width-height)))
 746     (postscript->pdf width height base-name tmp-name is-eps)))
 747
 748 (define-public (convert-to-png book base-name tmp-name is-eps)
 749   (let* ((defs (ly:paper-book-paper book))
 750          (resolution (output-resolution defs))
 751          (width-height (output-width-height defs))
 752          (width (car width-height))
 753          (height (cdr width-height)))
 754     (postscript->png resolution width height base-name tmp-name is-eps)))
 755
 756 (define-public (convert-to-ps book base-name tmp-name is-eps)
 757   (postscript->ps base-name tmp-name is-eps))
 758
 759 (define-public (output-classic-framework basename book scopes fields)
 760   (ly:error (_ "\nThe PostScript backend does not support the
 761 system-by-system output.  For that, use the EPS backend instead,
 762
 763   lilypond -dbackend=eps FILE
 764
 765 If you have cut & pasted a lilypond fragment from a webpage, be sure
 766 to only remove anything before
 767
 768   %% ****************************************************************
 769   %% Start cut-&-pastable-section
 770   %% ****************************************************************
 771 ")))