scm/output-gnome.scm

   1 ;;;; output-gnome.scm -- implement GNOME canvas output
   2 ;;;;
   3 ;;;;  source file of the GNU LilyPond music typesetter
   4 ;;;;
   5 ;;;; (c) 2004--2006 Jan Nieuwenhuizen <janneke@gnu.org>
   6
   7 ;;;; TODO:
   8 ;;;;
   9 ;;;;  * .cff MUST NOT be in fc's fontpath.
  10 ;;;;    - workaround: remove mf/out from ~/.fonts.conf,
  11 ;;;;      instead add ~/.fonts and symlink all /mf/out/*otf there.
  12 ;;;;    - bug in fontconfig/freetype/pango?
  13
  14 ;;;  * check: blot+scaling
  15 ;;;  * Figure out and fix font scaling and character placement
  16 ;;;  * EC font package: add missing X font directories and AFMs
  17 ;;;  * User-interface, keybindings
  18 ;;;  * Implement missing stencil functions
  19 ;;;  * Implement missing commands
  20 ;;;  * More information in stencils, e.g., location and grob tag.
  21 ;;;  * Embedded Lily:
  22 ;;;    - allow GnomeCanvas or `toplevel' GtkWindow to be created
  23 ;;;      outside of LilyPond
  24 ;;;    - lilylib.
  25 ;;;  * Release schedule and packaging of dependencies.
  26 ;;;    - g-wrap-1.9.3 is already in incoming.
  27 ;;;    - guile-gnome-platform-2.8.0 will probably be packaged early 2005.
  28
  29 ;;; You need:
  30 ;;;
  31 ;;;   * Rotty's g-wrap >= 1.9.3
  32 ;;;   * guile-gnome-platform >= 2.7.97
  33 ;;;   * pango >= 1.6.0
  34 ;;;
  35 ;;; See also: guile-gtk-general@gnu.org
  36
  37 ;;; Try it
  38 ;;;
  39 ;;;   * Install gnome/gtk and libffi development stuff
  40 ;;;
  41 ;;;   * Install [pango, g-wrap and] guile-gnome from source,
  42 ;;;     see buildscripts/guile-gnome.sh
  43 ;;;
  44 ;;;   * Build LilyPond with gui support: configure --enable-gui
  45 ;;;
  46 ;;;   * Supposing that LilyPond was built in ~/cvs/savannah/lilypond,
  47 ;;;     tell fontconfig about the feta fonts dir and run fc-cache
  48 "
  49 cat > ~/.fonts.conf << EOF
  50 <fontconfig>
  51 <dir>~/cvs/savannah/lilypond/mf/out</dir>
  52 <dir>/usr/share/texmf/fonts/type1/public/ec-fonts-mftraced</dir>
  53 </fontconfig>
  54 EOF
  55 fc-cache
  56 "
  57 ;;;     or copy all your .pfa/.pfb's to ~/.fonts if your fontconfig
  58 ;;;     already looks there for fonts.  Check if it works by doing:
  59 "
  60 fc-list | grep -i lily
  61 "
  62 ;;;
  63 ;;;   * Setup environment
  64 "
  65 export GUILE_LOAD_PATH=$HOME/usr/pkg/g-wrap/share/guile/site:$HOME/usr/pkg/g-wrap/share/guile/site/g-wrap:$HOME/usr/pkg/guile-gnome/share/guile:$GUILE_LOAD_PATH
  66 export LD_LIBRARY_PATH=$HOME/usr/pkg/pango/lib:$HOME/usr/pkg/g-wrap/lib:$HOME/usr/pkg/guile-gnome/lib:$LD_LIBRARY_PATH
  67 export XEDITOR='/usr/bin/emacsclient --no-wait +%l:%c %f'
  68 "
  69 ;;;  * Also for GNOME point-and-click, you need to set XEDITOR and add
  70 "
  71 #(ly:set-point-and-click 'line-column)
  72 "
  73 ;;;    to your .ly.
  74 ;;;
  75 ;;;  * Run lily:
  76 "
  77 lilypond -fgnome input/simple-song.ly
  78 "
  79 ;;; point-and-click: (mouse-1) click on a graphical object;
  80 ;;; grob-property-list: (mouse-3) click on a graphical object.
  81
  82 (define-module (scm output-gnome))
  83 (define this-module (current-module))
  84
  85 (use-modules
  86  (guile)
  87  (ice-9 regex)
  88  (srfi srfi-13)
  89  (lily)
  90  (gnome gtk)
  91  (gnome gw canvas))
  92
  93 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  94 ;;; globals
  95
  96 ;;; set by framework-gnome.scm
  97 (define canvas-root #f)
  98 (define output-scale #f)
  99
 100 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 101 ;; helper functions
 102
 103 (define (utf-8 i)
 104   (cond
 105    ((< i #x80) (list (integer->char i)))
 106    ((< i #x800) (map integer->char
 107                      (list (+ #xc0 (quotient i #x40))
 108                            (+ #x80 (modulo i #x40)))))
 109    ((< i #x10000)
 110     (let ((x (quotient i #x1000))
 111           (y (modulo i #x1000)))
 112       (map integer->char
 113            (list (+ #xe0 x)
 114                  (+ #x80 (quotient y #x40))
 115                  (+ #x80 (modulo y #x40))))))
 116    (else (begin (stderr "programming-error: utf-8 too big:~x\n" i)
 117                 (list (integer->char 32))))))
 118
 119 (define (integer->utf-8-string integer)
 120   (list->string (utf-8 integer)))
 121
 122 (define (char->utf-8-string char)
 123   (list->string (utf-8 (char->integer char))))
 124
 125 (define (string->utf-8-string string)
 126   (apply
 127    string-append
 128    (map (lambda (x) (char->utf-8-string x)) (string->list string))))
 129
 130 (define (music-font? font)
 131   (let ((family (car (font-name-style font))))
 132     (string=? (substring family 0 (min (string-length family) 10))
 133               "Emmentaler")))
 134
 135 ;;; FONT may be font smob, or pango font string
 136 (define (pango-font-name font)
 137   (if (string? font)
 138       (list font "Regular")
 139       (apply format (append '(#f "~a, ~a") (font-name-style font)))))
 140
 141 ;;; FONT may be font smob, or pango font string
 142 (define (canvas-font-size font)
 143   ;; FIXME: 1.85?
 144   (* 1.85
 145      (if (string? font)
 146          12
 147          (* output-scale (modified-font-metric-font-scaling font)))))
 148
 149 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 150 ;;; Wrappers from guile-gnome TLA
 151 ;;; guile-gnome-devel@gnu.org--2004
 152 ;;; http://arch.gna.org/guile-gnome/archive-2004
 153 ;;;
 154 ;;; janneke@gnu.org--2004-gnome
 155 ;;; http://lilypond.org/~janneke/{arch}/2004-gnome
 156 ;;;
 157 (if (not (defined? '<gnome-canvas-path-def>))
 158     (begin
 159       (define-class <gnome-canvas-path-def> (<gobject>)
 160         (closure #:init-value (gnome-canvas-path-def-new)
 161                  #:init-keyword #:path-def
 162                  #:getter get-def #:setter set-def))
 163
 164       (define-method (moveto (this <gnome-canvas-path-def>) x y)
 165         (gnome-canvas-path-def-moveto (get-def this) x y))
 166       (define-method (curveto (this <gnome-canvas-path-def>) x1 y1 x2 y2 x3 y3)
 167         (gnome-canvas-path-def-curveto (get-def this)  x1 y1 x2 y2 x3 y3))
 168       (define-method (lineto (this <gnome-canvas-path-def>) x y)
 169         (gnome-canvas-path-def-lineto (get-def this) x y))
 170       (define-method (closepath (this <gnome-canvas-path-def>))
 171         (gnome-canvas-path-def-closepath (get-def this)))
 172       (define-method (reset (this <gnome-canvas-path-def>))
 173         (gnome-canvas-path-def-reset (get-def this)))
 174
 175       (define -set-path-def set-path-def)
 176       (define -get-path-def get-path-def)
 177
 178       (define-method (set-path-def (this <gnome-canvas-shape>)
 179                                    (def <gnome-canvas-path-def>))
 180         (-set-path-def this (get-def def)))
 181
 182       (define-method (get-path-def (this <gnome-canvas-shape>))
 183         (make <gnome-canvas-path-def> #:path-def (-get-path-def this)))))
 184
 185 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 186 ;;; stencil outputters
 187 ;;;
 188
 189 ;;; catch-all for missing stuff
 190 ;;; comment this out to see find out what functions you miss :-)
 191 (define (dummy . foo) #f)
 192 (map (lambda (x) (module-define! this-module x dummy))
 193      (append
 194       (ly:all-stencil-expressions)
 195       (ly:all-output-backend-commands)))
 196
 197 ;; two beziers
 198 (define (bezier-sandwich lst thick)
 199   (let* ((def (make <gnome-canvas-path-def>))
 200          (bezier (make <gnome-canvas-bpath>
 201                    #:parent (canvas-root)
 202                    #:fill-color "black"
 203                    #:outline-color "black"
 204                    #:width-units thick
 205                    #:join-style 'round)))
 206
 207     (reset def)
 208
 209     ;; FIXME: LST is pre-mangled for direct ps stack usage
 210     ;; cl cr r l  0 1 2 3
 211     ;; cr cl l r  4 5 6 7
 212
 213     (moveto def (car (list-ref lst 3)) (- (cdr (list-ref lst 3))))
 214     (curveto def (car (list-ref lst 0)) (- (cdr (list-ref lst 0)))
 215              (car (list-ref lst 1)) (- (cdr (list-ref lst 1)))
 216              (car (list-ref lst 2)) (- (cdr (list-ref lst 2))))
 217
 218     (lineto def (car (list-ref lst 7)) (- (cdr (list-ref lst 7))))
 219     (curveto def (car (list-ref lst 4)) (- (cdr (list-ref lst 4)))
 220              (car (list-ref lst 5)) (- (cdr (list-ref lst 5)))
 221              (car (list-ref lst 6)) (- (cdr (list-ref lst 6))))
 222     (lineto def (car (list-ref lst 3)) (- (cdr (list-ref lst 3))))
 223
 224     (closepath def)
 225     (set-path-def bezier def)
 226     bezier))
 227
 228 (define (char font i)
 229   (text font (ly:font-index-to-charcode font i)))
 230
 231 (define (dashed-line thick on off dx dy)
 232   (draw-line thick 0 0 dx dy))
 233
 234 (define (draw-line thick x1 y1 x2 y2)
 235   (let* ((def (make <gnome-canvas-path-def>))
 236          (props (make <gnome-canvas-bpath>
 237                   #:parent (canvas-root)
 238                   #:fill-color "black"
 239                   #:outline-color "black"
 240                   #:width-units thick)))
 241     (reset def)
 242     (moveto def x1 (- y1))
 243     (lineto def x2 (- y2))
 244     (set-path-def props def)
 245     props))
 246
 247
 248 ;; FIXME: the framework-gnome backend needs to see every item that
 249 ;; gets created.  All items created here must should be put in a group
 250 ;; that gets returned.
 251 (define (glyph-string font postscript-font-name w-x-y-named-glyphs)
 252   (for-each
 253    (lambda (x)
 254
 255      ;; UGR, glyph names not found
 256      (stderr "GLYPH:~S\n" (caddr x))
 257      (stderr "ID:~S\n" (ly:font-glyph-name-to-charcode font (caddr x)))
 258      (placebox (cadr x) (caddr x)
 259                (make <gnome-canvas-text>
 260                  #:parent (canvas-root)
 261                  ;;#:x 0.0 #:y (if (music-font? font) 0.15 0.69)
 262                  #:x 0.0 #:y 0.0
 263                  #:anchor 'west
 264                  #:font (pango-font-name font)
 265                  #:size-points (canvas-font-size font)
 266                  #:size-set #t
 267                  #:text
 268                  (integer->utf-8-string
 269                   (ly:font-glyph-name-to-charcode font (cadddr x))))))
 270    w-x-y-named-glyphs))
 271
 272 (define (grob-cause offset grob)
 273   grob)
 274
 275
 276 (define (named-glyph font name)
 277   (text font (ly:font-glyph-name-to-charcode font name)))
 278
 279 (define (placebox x y expr)
 280   (let ((item expr))
 281     ;;(if item
 282     ;; FIXME ugly hack to skip #unspecified ...
 283     (if (and item (not (eq? item (if #f #f))))
 284         (begin
 285           (move item (* output-scale x) (* output-scale (- y)))
 286           (affine-relative item output-scale 0 0 output-scale 0 0)
 287           item)
 288         #f)))
 289
 290 (define (polygon coords blot-diameter)
 291   (let* ((def (make <gnome-canvas-path-def>))
 292          (props (make <gnome-canvas-bpath>
 293                   #:parent (canvas-root)
 294                   #:fill-color "black"
 295                   #:outline-color "black"
 296                   #:join-style 'round)
 297                 #:width-units blot-diameter)
 298          (points (ly:list->offsets '() coords))
 299          (last-point (car (last-pair points))))
 300
 301     (reset def)
 302     (moveto def (car last-point) (cdr last-point))
 303     (for-each (lambda (x) (lineto def (car x) (cdr x))) points)
 304     (closepath def)
 305     (set-path-def props def)
 306     props))
 307
 308 (define (round-filled-box breapth width depth height blot-diameter)
 309   (let ((r (/ blot-diameter 2)))
 310     (make <gnome-canvas-rect>
 311       #:parent (canvas-root)
 312       #:x1 (- r breapth) #:y1 (- depth r) #:x2 (- width r) #:y2 (- r height)
 313       #:fill-color "black"
 314       #:outline-color "black"
 315       #:width-units blot-diameter
 316       #:join-style 'round)))
 317
 318 (define (text font s)
 319   (make <gnome-canvas-text>
 320     #:parent (canvas-root)
 321     ;;#:x 0.0 #:y 0.0
 322     #:x 0.0 #:y (if (music-font? font) 0.15 0.69)
 323     #:anchor (if (music-font? font) 'west 'south-west)
 324     #:font (pango-font-name font)
 325     #:size-points (canvas-font-size font)
 326     #:size-set #t
 327     #:text (if (integer? s)
 328                (integer->utf-8-string s)
 329                (string->utf-8-string s))))
 330
 331 (define (utf-8-string pango-font-description string)
 332   (make <gnome-canvas-text>
 333     #:parent (canvas-root)
 334     #:x 0.0 #:y 0.0
 335     #:anchor 'west
 336     #:font pango-font-description
 337     #:size-points (canvas-font-size pango-font-description)
 338     #:size-set #t
 339     #:text string))