Doc-es: various updates.

[lilypond.git] / scm / output-socket.scm

diff --git a/scm/output-socket.scm b/scm/output-socket.scm
index 083d5a081be223493612e8be276aa4f366de2664..3532fc97325728e0e843ccbd5667d429083ee14a 100644 (file)
--- a/scm/output-socket.scm
+++ b/scm/output-socket.scm
@@ -1,62 +1,25 @@
+;;;; output-socket.scm
+;;;;
+;;;; implement network-based output (socket) in Scheme
 
 (define-module (scm output-socket)
-  #:re-export (quote)
-  )
+  #:re-export (quote))
 
 (use-modules (guile)
-            (srfi srfi-1)
-            (srfi srfi-13)
-            (lily))
-
-(define (dummy . rest)
-  "")
-
-(display (ly:all-stencil-expressions))
-(for-each
- (lambda (x) 
-   (module-define! (current-module)
-                  x
-                  dummy))
- 
- (ly:all-stencil-expressions))
-
-
-(define-public (draw-line thick x1 y1 x2 y2)
-  (format "drawline ~a ~a ~a ~a ~a"
-         thick x1 y2 x2 y2))
-
-(define-public (polygon xy-coords blot do-fill)
-  (format "polygon ~a ~a ~a"
-         blot
-         (if do-fill "True" "False")
-         (string-join
-          (map number->string xy-coords))
-  ))
-
-(define-public (named-glyph font glyph)
-  (format "glyphshow ~a \"~a\" ~a \"~a\""
-         (ly:font-glyph-name-to-charcode font glyph)
-         (ly:font-name font)
-         (modified-font-metric-font-scaling font)
-         glyph
-         ))
-
-(define-public (placebox x y s) 
-  (format "at ~a ~a ~a\n" x y s))
-
-(define-public (round-filled-box  breapth width depth height blot-diameter)
-  (format "draw_round_box ~a ~a ~a ~a ~a"
-         breapth width depth height blot-diameter
-         ))
+             (srfi srfi-1)
+             (srfi srfi-13)
+             (lily))
+
+
+(define format ergonomic-simple-format)
 
 (define (event-cause grob)
   (let*
-      ((cause (ly:grob-property  grob 'cause)))
+      ((cause (ly:grob-property grob 'cause)))
 
-    (cond
-     ((ly:stream-event? cause) cause)
-     (else
-      #f))))
+    (if (ly:stream-event? cause)
+        cause
+        #f)))
 
 (define (grob-bbox grob offset)
   (let*
@@ -66,59 +29,68 @@
        (y (cdr offset)))
 
     (if (interval-empty? x-ext)
-       (set! x-ext '(0 . 0)))
+        (set! x-ext '(0 . 0)))
 
     (if (interval-empty? y-ext)
-       (set! y-ext '(0 . 0)))
-    
+        (set! y-ext '(0 . 0)))
+
     (list (+ x (car x-ext))
-         (+ y (car y-ext))
-         (+ x (cdr x-ext))
-         (+ y (cdr y-ext))
-         )))
+          (+ y (car y-ext))
+          (+ x (cdr x-ext))
+          (+ y (cdr y-ext)))))
 
-(define-public (no-origin)
-  "nocause\n")
+(define (escape-string str)
+  (string-regexp-substitute
+   " " "\\040"
+   (string-regexp-substitute "\"" "\\\"" str)))
 
-(define-public (grob-cause offset grob)
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;;; stencil commands
+;;;
+
+(define (draw-line thick x1 y1 x2 y2)
+  (format #f "drawline ~a ~a ~a ~a ~a"
+          thick x1 y2 x2 y2))
+
+(define (grob-cause offset grob)
   (let*
       ((cause (event-cause grob))
        (tag (if (and cause (integer? (ly:event-property cause 'input-tag)))
-               (ly:event-property cause 'input-tag)
-               -1))
-       (name (cdr (assoc 'name (ly:grob-property grob 'meta))))
-       )
-    
-    (apply format
-          (append (list "cause ~a \"~a\" ~a ~a ~a ~a\n"
-                        tag name)
-          
-                  (grob-bbox grob offset))
-         )))
-
+                (ly:event-property cause 'input-tag)
+                -1))
+       (name (assoc-get 'name (ly:grob-property grob 'meta))))
+
+    (apply format #f
+           "cause ~a \"~a\" ~a ~a ~a ~a\n" tag name
+           (grob-bbox grob offset))))
+
+(define (named-glyph font glyph)
+  (format #f "glyphshow ~a \"~a\" ~a \"~a\""
+          (ly:font-glyph-name-to-charcode font glyph)
+          (ly:font-name font)
+          (modified-font-metric-font-scaling font)
+          glyph))
+
+(define (no-origin)
+  "nocause\n")
 
-(define (escape-string str)
-  (string-regexp-substitute
-   " " "\\040" 
-   (string-regexp-substitute "\"" "\\\"" str)))
-  
-(define-public (utf-8-string
-               descr
-               string)
-  
-  (format "utf-8 \"~a\" \"~a\""
-         (escape-string descr)
-
-         ;; don't want unescaped spaces.
-         (escape-string string)
-         ))
-
-
-(define (bezier-sandwich lst thick)
-  (format
-   #f
-   "bezier_sandwich ~a [~a]"
-   thick
-   (string-append 
-    (string-join (map (lambda (x) (format "(~a,~a)" (car x) (cdr x)))
-                     lst) ","))))
+(define (placebox x y s)
+  (if (not (string-null? s))
+      (format #f "at ~a ~a ~a\n" x y s)
+      ""))
+
+(define (polygon xy-coords blot do-fill)
+  (format #f "polygon ~a ~a ~a"
+          blot
+          (if do-fill "True" "False")
+          (string-join (map number->string xy-coords))))
+
+(define (round-filled-box breapth width depth height blot-diameter)
+  (format #f "draw_round_box ~a ~a ~a ~a ~a"
+          breapth width depth height blot-diameter))
+
+(define (utf-8-string descr string)
+  (format #f "utf-8 \"~a\" \"~a\""
+          (escape-string descr)
+          ;; don't want unescaped spaces.
+          (escape-string string)))