2 stencil.hh -- declare Stencil
4 source file of the GNU LilyPond music typesetter
6 (c) 1997--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
11 #include <stdlib.h> // size_t
12 #include "lily-proto.hh"
14 #include "direction.hh"
15 #include "lily-guile.hh"
18 /** a group of individually translated symbols. You can add stencils
19 to the top, to the right, etc.
21 It is implemented as a "tree" of scheme expressions, as in
23 Expr = combine Expr Expr
24 | translate Offset Expr
28 SCHEME is a Scheme expression that --when eval'd-- produces the
33 * Because of the way that Stencil is implemented, it is the most
34 efficient to add "fresh" stencils to what you're going to build.
36 * Do not create Stencil objects on the heap. That includes passing
37 around Stencil* which are produced by unsmob_stencil().
39 * Empty stencils have empty dimensions. If add_at_edge is used to
40 init the stencil, we assume that
42 DIMENSIONS = (Interval (0,0),Interval (0,0)
46 friend SCM ly_stencil_set_extent_x (SCM, SCM, SCM);
49 This provides the reference point of the symbol, for example with
50 characters, it is on the base line of the character. Usually,
57 DECLARE_SIMPLE_SMOBS (Stencil,);
62 Offset origin () const;
66 Set dimensions to empty, or to (Interval (0,0),Interval (0,0) */
67 void set_empty (bool);
68 Stencil moved_to_edge (Axis a, Direction d, const Stencil &m, Real padding,
71 void add_at_edge (Axis a, Direction d, const Stencil &m, Real padding,
73 void add_stencil (Stencil const &m);
74 void translate (Offset);
75 void align_to (Axis a, Real x);
76 void translate_axis (Real,Axis);
78 Interval extent (Axis) const;
79 Box extent_box () const;
80 bool is_empty () const;
82 static SCM ly_get_stencil_extent (SCM mol, SCM axis);
83 static SCM ly_set_stencil_extent_x (SCM,SCM,SCM);
84 static SCM ly_stencil_combined_at_edge (SCM,SCM,SCM,SCM,SCM);
88 DECLARE_UNSMOB(Stencil,stencil);
89 SCM fontify_atom (Font_metric const*, SCM atom);
91 Stencil create_stencil (SCM print);