* Documentation/topdocs/NEWS.tely (Top): doc new clipping feature

* input/regression/clip-systems.ly (Notes): new file.

diff --git a/ChangeLog b/ChangeLog
index 60568944f0d14c08ef053d4c3b7f659dc2f4ed33..e9aba0fb54fc8b225b9c0cbfff216c54b5d00521 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2006-10-12  Han-Wen Nienhuys  <hanwen@lilypond.org>
 
+       * Documentation/topdocs/NEWS.tely (Top): doc new clipping feature
+
+       * input/regression/clip-systems.ly (Notes): new file. 
+
        * scm/lily.scm (define-scheme-options): add clip-systems option.
 
        * scm/framework-ps.scm (dump-stencil-as-EPS-with-bbox): new

diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 701fd2f9f05d4c8873843f48e5453ee2d945ccca..dcb0f2e74ef99668a557584aa817969ed65c11c1 100644 (file)
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -75,9 +75,6 @@ An example is shown in @file{input/regression/clip-systems.ly}. This
 feature was sponsored by Rick Hansen.
 
 
-
-
-
 @item Lyric texts may include tie symbols by using the @code{~}
 symbol,
 

diff --git a/input/regression/clip-systems.ly b/input/regression/clip-systems.ly
new file mode 100644 (file)
index 0000000..1893821
--- /dev/null
+++ b/input/regression/clip-systems.ly
@@ -0,0 +1,61 @@
+\header {
+  texidoc = "Clipping snippets from a finished score
+
+Notes:
+
+@itemize @bullet
+@item If system starts and ends are included, they include extents of the System grob, eg. instrument names.
+@item Grace notes  at the end point of the region are not included
+@item Regions can span multiple systems. In this case, multiple EPS files are generated.
+@end itemize
+
+This file needs to be run separately with @code{-dclip-systems}; the
+collated-files.html of the regression test does not adequately show
+the results.
+
+The result will be files named @file{@var{base}-system-@var{systemnumber}-@var{start}-@var{end}.eps}.
+
+"
+
+}
+
+\version "2.9.23"
+
+
+% each clip-region is a (START . END) pair
+% where both are rhythmic-locations.
+
+% (make-rhythmic-locations BAR-NUMBER NUM DEN)
+% means NUM/DEN whole-notes into bar numbered BAR-NUMBER
+
+\paper {
+
+  clip-regions
+  = #(list
+      (cons
+       (make-rhythmic-location 2 0 1)
+       (make-rhythmic-location 4 0 1))
+
+      (cons
+       (make-rhythmic-location 0 0 1)
+       (make-rhythmic-location 4 0 1))
+      
+      (cons
+       (make-rhythmic-location 0 0 1)
+       (make-rhythmic-location 6 0 1))
+    )
+}
+
+\relative {
+  \set Staff.instrumentName = #"bla"
+  c1
+  d
+  \grace c16
+  e1
+  \key d\major
+  
+  f
+  \break  \clef bass
+  g,
+  fis
+}