X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Finclude%2Fstencil.hh;h=6b78c18e4b313ac59980909a917ed6dd90556152;hb=47db9a3883d726ca53e2133a3b2298f78dd6a32e;hp=47abea6937fe05449cfc3a377fa69e39878092df;hpb=e24df7c27635dc996c466295eacf2981bddccaf7;p=lilypond.git diff --git a/lily/include/stencil.hh b/lily/include/stencil.hh index 47abea6937..6b78c18e4b 100644 --- a/lily/include/stencil.hh +++ b/lily/include/stencil.hh @@ -1,14 +1,26 @@ /* - stencil.hh -- declare Stencil + This file is part of LilyPond, the GNU music typesetter. - source file of the GNU LilyPond music typesetter + Copyright (C) 1997--2015 Han-Wen Nienhuys - (c) 1997--2005 Han-Wen Nienhuys + LilyPond is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + LilyPond is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with LilyPond. If not, see . */ #ifndef STENCIL_HH #define STENCIL_HH -#include // size_t +#include // size_t +using namespace std; #include "lily-proto.hh" #include "box.hh" @@ -19,83 +31,77 @@ It is implemented as a "tree" of scheme expressions, as in - Expr = combine Expr-list - | translate Offset Expr - | origin (ORIGIN) Expr - | no-origin Expr - | (SCHEME) - ; + Expr = combine Expr-list + | translate Offset Expr + | origin (ORIGIN) Expr + | no-origin Expr + | (SCHEME) + ; SCHEME is a Scheme expression that --when eval'd-- produces the - desired output. + desired output. Notes: - + * Because of the way that Stencil is implemented, it is the most efficient to add "fresh" stencils to what you're going to build. * Do not create Stencil objects on the heap. That includes passing - around Stencil* which are produced by unsmob_stencil(). Either + around Stencil* which are produced by Stencil::unsmob(). Either copy Stencil objects, or use SCM references. - + * Empty stencils have empty dimensions. If add_at_edge is used to init the stencil, we assume that - DIMENSIONS = (Interval (0,0),Interval (0,0) + DIMENSIONS = (Interval (0, 0), Interval (0, 0) */ -class Stencil +class Stencil : public Simple_smob { - friend SCM ly_stencil_set_extent_x (SCM, SCM, SCM); - - /* - This provides the reference point of the symbol, for example with - characters, it is on the base line of the character. Usually, - ORIGIN is inside DIM_ - */ - Offset origin_; +public: + SCM mark_smob (); + static const char type_p_name_[]; +private: Box dim_; SCM expr_; - - DECLARE_SIMPLE_SMOBS (Stencil,); + public: Stencil (Box, SCM s); Stencil (); - - Offset origin () const; + SCM expr () const; /** - Set dimensions to empty, or to (Interval (0,0),Interval (0,0) */ + Set dimensions to empty, or to (Interval (0, 0), Interval (0, 0) */ void set_empty (bool); - Stencil moved_to_edge (Axis a, Direction d, const Stencil &m, Real padding, - Real minimum) const; - - void add_at_edge (Axis a, Direction d, const Stencil &m, Real padding, - Real minimum); + void add_at_edge (Axis a, Direction d, const Stencil &m, Real padding); + void stack (Axis a, Direction d, const Stencil &m, Real padding, Real mindist); void add_stencil (Stencil const &m); void translate (Offset); + Stencil translated (Offset) const; + void rotate (Real, Offset); + void rotate_degrees (Real, Offset); + void rotate_degrees_absolute (Real, Offset); void align_to (Axis a, Real x); - void translate_axis (Real,Axis); - + void translate_axis (Real, Axis); + void scale (Real, Real); + Interval extent (Axis) const; Box extent_box () const; bool is_empty () const; - - static SCM ly_get_stencil_extent (SCM mol, SCM axis); - static SCM ly_set_stencil_extent_x (SCM,SCM,SCM); - static SCM ly_stencil_combined_at_edge (SCM,SCM,SCM,SCM,SCM); + bool is_empty (Axis) const; + Stencil in_color (Real r, Real g, Real b) const; + static SCM skylines_from_stencil (SCM, Real, Axis); }; -DECLARE_UNSMOB(Stencil,stencil); -SCM fontify_atom (Font_metric const*, SCM atom); - void interpret_stencil_expression (SCM expr, - void (*func) (void*, SCM), - void *func_arg, - Offset o); - -Stencil create_stencil (SCM print); + SCM (*func) (void *, SCM), + void *func_arg, + Offset o); SCM find_expression_fonts (SCM expr); +void register_stencil_head (SCM symbol); +bool is_stencil_head (SCM symbol); +SCM all_stencil_heads (); + #endif /* STENCIL_HH */