X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Fgrob.cc;h=d44f3ce7c53aab0665404436af76107d698e7b4e;hb=402045837e7134cdf90d1fcf31768c62227a4936;hp=eb42b0c4973cd6246a3d7c149a6bfc6c41e6a7e1;hpb=cbe377fddae9700d850ecf1be0277f73288a9d87;p=lilypond.git diff --git a/lily/grob.cc b/lily/grob.cc index eb42b0c497..d44f3ce7c5 100644 --- a/lily/grob.cc +++ b/lily/grob.cc @@ -3,7 +3,7 @@ source file of the GNU LilyPond music typesetter - (c) 1997--2002 Han-Wen Nienhuys + (c) 1997--2004 Han-Wen Nienhuys */ @@ -12,21 +12,18 @@ #include "main.hh" #include "input-smob.hh" - +#include "warn.hh" #include "group-interface.hh" #include "misc.hh" #include "paper-score.hh" -#include "paper-def.hh" -#include "molecule.hh" +#include "stencil.hh" #include "grob.hh" -#include "debug.hh" +#include "warn.hh" #include "spanner.hh" #include "system.hh" #include "item.hh" -#include "paper-column.hh" -#include "molecule.hh" +#include "stencil.hh" #include "misc.hh" -#include "paper-outputter.hh" #include "music.hh" #include "item.hh" @@ -39,7 +36,8 @@ remove dynamic_cast and put this code into respective subclass. */ - +//#define HASHING_FOR_MUTABLE_PROPS +#define HASH_SIZE 3 #define INFINITY_MSG "Infinity or NaN encountered" Grob::Grob (SCM basicprops) @@ -47,10 +45,10 @@ Grob::Grob (SCM basicprops) /* fixme: default should be no callback. */ - - pscore_l_=0; - status_c_ = 0; - original_l_ = 0; + self_scm_ = SCM_EOL; + pscore_=0; + status_ = 0; + original_ = 0; immutable_property_alist_ = basicprops; mutable_property_alist_ = SCM_EOL; @@ -62,17 +60,22 @@ Grob::Grob (SCM basicprops) smobify_self (); +#ifdef HASHING_FOR_MUTABLE_PROPS + mutable_property_alist_ = scm_c_make_hash_table (HASH_SIZE); +#endif + SCM meta = get_grob_property ("meta"); if (gh_pair_p (meta)) { SCM ifs = scm_assoc (ly_symbol2scm ("interfaces"), meta); /* - do it directly to bypass interface checks. + Switch off interface checks for the moment. */ - mutable_property_alist_ = gh_cons (gh_cons (ly_symbol2scm ("interfaces"), - gh_cdr (ifs)), - mutable_property_alist_); + bool itc = internal_type_checking_global_b; + internal_type_checking_global_b = false; + internal_set_grob_property (ly_symbol2scm ("interfaces"), gh_cdr(ifs)); + internal_type_checking_global_b = itc; } /* @@ -83,6 +86,7 @@ Grob::Grob (SCM basicprops) eg. when using \override with StaffSymbol. */ char const*onames[] = {"X-offset-callbacks", "Y-offset-callbacks"}; + char const*xnames[] = {"X-extent", "Y-extent"}; char const*enames[] = {"X-extent-callback", "Y-extent-callback"}; for (int a = X_AXIS; a <= Y_AXIS; a++) @@ -100,15 +104,17 @@ Grob::Grob (SCM basicprops) } SCM cb = get_grob_property (enames[a]); - + SCM xt = get_grob_property (xnames[a]); + /* - Should change default to be empty? + Should change default to empty? */ - if (cb != SCM_BOOL_F + if (is_number_pair (xt)) + cb = xt; + else if (cb != SCM_BOOL_F && !gh_procedure_p (cb) && !gh_pair_p (cb) - && gh_procedure_p (get_grob_property ("molecule-callback")) - ) - cb = molecule_extent_proc; + && gh_procedure_p (get_grob_property ("print-function"))) + cb = stencil_extent_proc; dim_cache_[a].dimension_ = cb; } @@ -118,20 +124,24 @@ Grob::Grob (SCM basicprops) Grob::Grob (Grob const&s) : dim_cache_ (s.dim_cache_) { - original_l_ = (Grob*) &s; + original_ = (Grob*) &s; + self_scm_ = SCM_EOL; + immutable_property_alist_ = s.immutable_property_alist_; mutable_property_alist_ = SCM_EOL; - + /* No properties are copied. That is the job of handle_broken_dependencies. */ - status_c_ = s.status_c_; - pscore_l_ = s.pscore_l_; + status_ = s.status_; + pscore_ = 0; smobify_self (); - +#ifdef HASHING_FOR_MUTABLE_PROPS + mutable_property_alist_ = scm_c_make_hash_table (HASH_SIZE); +#endif } Grob::~Grob () @@ -142,118 +152,39 @@ Grob::~Grob () } - -extern void check_interfaces_for_property (Grob const *me, SCM sym); - -void -Grob::internal_set_grob_property (SCM s, SCM v) -{ -#ifndef NDEBUG - if (internal_type_checking_global_b) - { - assert (type_check_assignment (s, v, ly_symbol2scm ("backend-type?"))); - check_interfaces_for_property(this, s); - } -#endif - - - mutable_property_alist_ = scm_assq_set_x (mutable_property_alist_, s, v); -} - - -SCM -Grob::internal_get_grob_property (SCM sym) const -{ - SCM s = scm_sloppy_assq (sym, mutable_property_alist_); - if (s != SCM_BOOL_F) - return ly_cdr (s); - - s = scm_sloppy_assq (sym, immutable_property_alist_); - -#ifndef NDEBUG - if (internal_type_checking_global_b && gh_pair_p (s)) - { - assert (type_check_assignment (sym, gh_cdr (s), ly_symbol2scm ("backend-type?"))); - check_interfaces_for_property(this, sym); - } -#endif - - return (s == SCM_BOOL_F) ? SCM_EOL : ly_cdr (s); -} - -/* - Remove the value associated with KEY, and return it. The result is - that a next call will yield SCM_EOL (and not the underlying - `basic' property. -*/ -SCM -Grob::remove_grob_property (const char* key) -{ - SCM val = get_grob_property (key); - if (val != SCM_EOL) - set_grob_property (key, SCM_EOL); - return val; -} - - - -MAKE_SCHEME_CALLBACK (Grob,molecule_extent,2); +MAKE_SCHEME_CALLBACK (Grob,stencil_extent,2); SCM -Grob::molecule_extent (SCM element_smob, SCM scm_axis) +Grob::stencil_extent (SCM element_smob, SCM scm_axis) { Grob *s = unsmob_grob (element_smob); Axis a = (Axis) gh_scm2int (scm_axis); - Molecule *m = s->get_molecule (); + Stencil *m = s->get_stencil (); Interval e ; if (m) e = m->extent (a); return ly_interval2scm (e); } -MAKE_SCHEME_CALLBACK (Grob,preset_extent,2); - -SCM -Grob::preset_extent (SCM element_smob, SCM scm_axis) -{ - Grob *s = unsmob_grob (element_smob); - Axis a = (Axis) gh_scm2int (scm_axis); - - SCM ext = s->get_grob_property ((a == X_AXIS) - ? "extent-X" - : "extent-Y"); - - if (gh_pair_p (ext)) - { - Real l = gh_scm2double (ly_car (ext)); - Real r = gh_scm2double (ly_cdr (ext)); - return ly_interval2scm (Interval (l, r)); - } - - return ly_interval2scm (Interval ()); -} - - - Paper_def* -Grob::paper_l () const +Grob::get_paper () const { - return pscore_l_ ? pscore_l_->paper_l_ : 0; + return pscore_ ? pscore_->paper_ : 0; } void Grob::calculate_dependencies (int final, int busy, SCM funcname) { - if (status_c_ >= final) + if (status_ >= final) return; - if (status_c_== busy) + if (status_== busy) { programming_error ("Element is busy, come back later"); return; } - status_c_= busy; + status_= busy; for (SCM d = get_grob_property ("dependencies"); gh_pair_p (d); d = ly_cdr (d)) @@ -267,69 +198,72 @@ Grob::calculate_dependencies (int final, int busy, SCM funcname) if (gh_procedure_p (proc)) gh_call1 (proc, this->self_scm ()); - status_c_= final; + status_= final; } -Molecule * -Grob::get_molecule () const +Stencil * +Grob::get_stencil () const { - if (immutable_property_alist_ == SCM_EOL) + if (!live()) { return 0; - } - SCM mol = get_grob_property ("molecule"); - if (unsmob_molecule (mol)) - return unsmob_molecule (mol); + SCM mol = get_grob_property ("stencil"); + if (unsmob_stencil (mol)) + return unsmob_stencil (mol); - mol = get_uncached_molecule (); + mol = get_uncached_stencil (); - Grob *me = (Grob*)this; - me->set_grob_property ("molecule", mol); + if (live ()) + { + Grob *me = (Grob*)this; + me->set_grob_property ("stencil", mol); + } - return unsmob_molecule (mol); + return unsmob_stencil (mol); } + SCM -Grob::get_uncached_molecule ()const +Grob::get_uncached_stencil ()const { - SCM proc = get_grob_property ("molecule-callback"); + SCM proc = get_grob_property ("print-function"); SCM mol = SCM_EOL; if (gh_procedure_p (proc)) mol = gh_apply (proc, scm_list_n (this->self_scm (), SCM_UNDEFINED)); - - Molecule *m = unsmob_molecule (mol); + Stencil *m = unsmob_stencil (mol); - if (unsmob_molecule (mol)) + if (unsmob_stencil (mol)) { SCM origin = ly_symbol2scm ("no-origin"); - if (store_locations_global_b){ - SCM cause = get_grob_property ("cause"); - if (Music*m = unsmob_music (cause)) - { - SCM music_origin = m->get_mus_property ("origin"); - if (unsmob_input (music_origin)) - origin = music_origin; - } + if (store_locations_global_b) + { + SCM cause = get_grob_property ("cause"); + if (Music*m = unsmob_music (cause)) + { + SCM music_origin = m->get_mus_property ("origin"); + if (unsmob_input (music_origin)) + origin = music_origin; + } } // ugr. - mol = Molecule (m->extent_box (), + mol = Stencil (m->extent_box (), scm_list_n (origin, m->get_expr (), SCM_UNDEFINED) ). smobbed_copy (); - m = unsmob_molecule (mol); + m = unsmob_stencil (mol); } /* transparent retains dimensions of element. */ if (m && to_boolean (get_grob_property ("transparent"))) - mol = Molecule (m->extent_box (), SCM_EOL).smobbed_copy (); + mol = Stencil (m->extent_box (), SCM_EOL).smobbed_copy (); return mol; } @@ -344,13 +278,8 @@ Grob::do_break_processing () { } - - - - - System * -Grob::line_l () const +Grob::get_system () const { return 0; } @@ -367,143 +296,39 @@ Grob::add_dependency (Grob*e) } - - -/** - Do break substitution in S, using CRITERION. Return new value. - CRITERION is either a SMOB pointer to the desired line, or a number - representing the break direction. Do not modify SRC. - - It is rather tightly coded, since it takes a lot of time; it is - one of the top functions in the profile. - - We don't pass break_criterion as a parameter, since it is - `constant', but takes up stack space. - -*/ - - -static SCM break_criterion; -void -set_break_subsititution (SCM criterion) -{ - break_criterion = criterion; -} - -SCM -do_break_substitution (SCM src) -{ - again: - - if (Grob *sc = unsmob_grob (src)) - { - if (SCM_INUMP (break_criterion)) - { - Item * i = dynamic_cast (sc); - Direction d = to_dir (break_criterion); - if (i && i->break_status_dir () != d) - { - Item *br = i->find_prebroken_piece (d); - return (br) ? br->self_scm () : SCM_UNDEFINED; - } - } - else - { - System * line - = dynamic_cast (unsmob_grob (break_criterion)); - if (sc->line_l () != line) - { - sc = sc->find_broken_piece (line); - - } - - /* now: !sc || (sc && sc->line_l () == line) */ - if (!sc) - return SCM_UNDEFINED; - - /* now: sc && sc->line_l () == line */ - if (!line) - return sc->self_scm(); - /* - This was introduced in 1.3.49 as a measure to prevent - programming errors. It looks expensive (?). - - TODO: - - benchmark , document when (what kind of programming - errors) this happens. - */ - if (sc->common_refpoint (line, X_AXIS) - && sc->common_refpoint (line, Y_AXIS)) - { - return sc->self_scm (); - } - return SCM_UNDEFINED; - } - } - else if (ly_pair_p (src)) - { - /* - UGH! breaks on circular lists. - */ - SCM newcar = do_break_substitution (ly_car (src)); - SCM oldcdr = ly_cdr (src); - - if (newcar == SCM_UNDEFINED - && (gh_pair_p (oldcdr) || oldcdr == SCM_EOL)) - { - /* - This is tail-recursion, ie. - - return do_break_substution (cdr); - - We don't want to rely on the compiler to do this. Without - tail-recursion, this easily crashes with a stack overflow. */ - src = oldcdr; - goto again; - } - - return scm_cons (newcar, do_break_substitution (oldcdr)); - } - else - return src; - - return src; -} - void Grob::handle_broken_dependencies () { - Spanner * s= dynamic_cast (this); - if (original_l_ && s) + Spanner * sp = dynamic_cast (this); + if (original_ && sp) return; - if (s) + if (sp) { - for (int i = 0; i< s->broken_into_l_arr_ .size (); i++) + /* + This is the original spanner. We use a special function + because some Spanners have enormously long lists in their + properties. + */ + for (SCM s = mutable_property_alist_; gh_pair_p(s); + s = gh_cdr(s)) { - Grob * sc = s->broken_into_l_arr_[i]; - System * l = sc->line_l (); - - set_break_subsititution (l ? l->self_scm () : SCM_UNDEFINED); - sc->mutable_property_alist_ = - do_break_substitution (mutable_property_alist_); - + sp->substitute_one_mutable_property (gh_caar (s), + gh_cdar (s)); } } + System *system = get_system (); - System *line = line_l (); - - if (line && common_refpoint (line, X_AXIS) && common_refpoint (line, Y_AXIS)) + if (live () + && system && common_refpoint (system, X_AXIS) && common_refpoint (system, Y_AXIS)) { - set_break_subsititution (line ? line->self_scm () : SCM_UNDEFINED); - mutable_property_alist_ = do_break_substitution (mutable_property_alist_); + substitute_mutable_properties (system ? system->self_scm () : SCM_UNDEFINED, + mutable_property_alist_); } else if (dynamic_cast (this)) { - set_break_subsititution (SCM_UNDEFINED); - mutable_property_alist_ = do_break_substitution (mutable_property_alist_); + substitute_mutable_properties (SCM_UNDEFINED, mutable_property_alist_); } else { @@ -511,9 +336,10 @@ Grob::handle_broken_dependencies () This element is `invalid'; it has been removed from all dependencies, so let's junk the element itself. - do not do this for System, since that would remove - references to the originals of score-grobs, which get then GC'd - (a bad thing.) + do not do this for System, since that would remove references + to the originals of score-grobs, which get then GC'd (a bad + thing.) + */ suicide (); } @@ -527,6 +353,13 @@ Grob::handle_broken_dependencies () void Grob::suicide () { + if (!live ()) + return; + +#if 0 // see below. + String nm = name(); +#endif + mutable_property_alist_ = SCM_EOL; immutable_property_alist_ = SCM_EOL; @@ -538,11 +371,34 @@ Grob::suicide () dim_cache_[a].offset_callbacks_ = SCM_EOL; dim_cache_[a].offsets_left_ = 0; } + +#if 0 + /* + This can make debugging a little easier: we can still know what + the object used to be. However, since all its links have been + broken, it's usually more convenient to set a conditional + breakpoint in GDB before the property lists are wiped. + */ + mutable_property_alist_ = scm_acons (ly_symbol2scm ("name"), + scm_makfrom0str (nm.to_str0()), + mutable_property_alist_ + ); +#endif } void Grob::handle_prebroken_dependencies () { + /* + Don't do this in the derived method, since we want to keep access to + mutable_property_alist_ centralized. + */ + if (original_) + { + Item * it = dynamic_cast (this); + substitute_mutable_properties (gh_int2scm (it->break_status_dir ()), + original_->mutable_property_alist_); + } } Grob* @@ -583,10 +439,10 @@ Grob::relative_coordinate (Grob const*refp, Axis a) const not ask for the absolute coordinate (ie. REFP == nil.) */ - if (refp == dim_cache_[a].parent_l_) + if (refp == dim_cache_[a].parent_) return get_offset (a); else - return get_offset (a) + dim_cache_[a].parent_l_->relative_coordinate (refp, a); + return get_offset (a) + dim_cache_[a].parent_->relative_coordinate (refp, a); } @@ -616,15 +472,8 @@ Grob::get_offset (Axis a) const } -MAKE_SCHEME_CALLBACK (Grob,point_dimension_callback,2); -SCM -Grob::point_dimension_callback (SCM , SCM) -{ - return ly_interval2scm (Interval (0,0)); -} - bool -Grob::empty_b (Axis a)const +Grob::is_empty (Axis a)const { return ! (gh_pair_p (dim_cache_[a].dimension_) || gh_procedure_p (dim_cache_[a].dimension_)); @@ -656,8 +505,8 @@ Grob::extent (Grob * refp, Axis a) const ext = ly_scm2interval (d->dimension_); SCM extra = get_grob_property (a == X_AXIS - ? "extra-extent-X" - : "extra-extent-Y"); + ? "extra-X-extent" + : "extra-Y-extent"); /* signs ? @@ -669,8 +518,8 @@ Grob::extent (Grob * refp, Axis a) const } extra = get_grob_property (a == X_AXIS - ? "minimum-extent-X" - : "minimum-extent-Y"); + ? "minimum-X-extent" + : "minimum-Y-extent"); if (gh_pair_p (extra)) { ext.unite (Interval (gh_scm2double (ly_car (extra)), @@ -692,8 +541,8 @@ Grob::common_refpoint (Grob const* s, Axis a) const I don't like the quadratic aspect of this code, but I see no other way. The largest chain of parents might be 10 high or so, so it shouldn't be a real issue. */ - for (Grob const *c = this; c; c = c->dim_cache_[a].parent_l_) - for (Grob const * d = s; d; d = d->dim_cache_[a].parent_l_) + for (Grob const *c = this; c; c = c->dim_cache_[a].parent_) + for (Grob const * d = s; d; d = d->dim_cache_[a].parent_) if (d == c) return (Grob*)d; @@ -779,7 +628,7 @@ Grob::set_extent (SCM dc, Axis a) void Grob::set_parent (Grob *g, Axis a) { - dim_cache_[a].parent_l_ = g; + dim_cache_[a].parent_ = g; } MAKE_SCHEME_CALLBACK (Grob,fixup_refpoint,1); @@ -795,9 +644,9 @@ Grob::fixup_refpoint (SCM smob) if (!parent) continue; - if (parent->line_l () != me->line_l () && me->line_l ()) + if (parent->get_system () != me->get_system () && me->get_system ()) { - Grob * newparent = parent->find_broken_piece (me->line_l ()); + Grob * newparent = parent->find_broken_piece (me->get_system ()); me->set_parent (newparent, ax); } @@ -823,9 +672,8 @@ void Grob::warning (String s)const { SCM cause = self_scm(); - while (cause != SCM_EOL && !unsmob_music (cause)) + while (Grob * g = unsmob_grob (cause)) { - Grob * g = unsmob_grob (cause); cause = g->get_grob_property ("cause"); } @@ -859,21 +707,27 @@ Grob::mark_smob (SCM ses) { Grob * s = (Grob*) SCM_CELL_WORD_1 (ses); scm_gc_mark (s->immutable_property_alist_); - scm_gc_mark (s->mutable_property_alist_); for (int a =0 ; a < 2; a++) { scm_gc_mark (s->dim_cache_[a].offset_callbacks_); scm_gc_mark (s->dim_cache_[a].dimension_); - Grob *p = s->get_parent (Y_AXIS); - if (p) - scm_gc_mark (p->self_scm ()); + + /* + don't mark the parents. The pointers in the mutable property + list form two tree like structures (one for X relations, one + for Y relations). Marking these can be done in limited stack + space. If we add the parents, we will jump between X and Y in + an erratic manner, leading to much more recursion depth (and + core dumps if we link to pthreads.) + */ } - if (s->original_l_) - scm_gc_mark (s->original_l_->self_scm ()); + if (s->original_) + scm_gc_mark (s->original_->self_scm ()); - return s->do_derived_mark (); + s->do_derived_mark (); + return s->mutable_property_alist_; } int @@ -882,7 +736,7 @@ Grob::print_smob (SCM s, SCM port, scm_print_state *) Grob *sc = (Grob *) ly_cdr (s); scm_puts ("#name ().ch_C (), port); + scm_puts ((char *)sc->name ().to_str0 (), port); /* don't try to print properties, that is too much hassle. @@ -892,39 +746,11 @@ Grob::print_smob (SCM s, SCM port, scm_print_state *) } SCM -Grob::do_derived_mark () +Grob::do_derived_mark () const { return SCM_EOL; } -LY_DEFINE(ly_set_grob_property,"ly-set-grob-property", 3, 0, 0, -(SCM grob, SCM sym, SCM val), -" -Set @var{sym} in grob @var{grob} to value @var{val}") -{ - Grob * sc = unsmob_grob (grob); - SCM_ASSERT_TYPE(sc, grob, SCM_ARG1, __FUNCTION__, "grob"); - SCM_ASSERT_TYPE(gh_symbol_p(sym), sym, SCM_ARG2, __FUNCTION__, "symbol"); - - if (!type_check_assignment (sym, val, ly_symbol2scm ("backend-type?"))) - error ("typecheck failed"); - - sc->internal_set_grob_property (sym, val); - return SCM_UNSPECIFIED; -} - -LY_DEFINE(ly_get_grob_property, - "ly-get-grob-property", 2, 0, 0, (SCM grob, SCM sym), - " Get the value of a value in grob @var{g} of property @var{sym}. It -will return @code{'()} (end-of-list) if @var{g} doesn't have @var{sym} set. -") -{ - Grob * sc = unsmob_grob (grob); - SCM_ASSERT_TYPE(sc, grob, SCM_ARG1, __FUNCTION__, "grob"); - SCM_ASSERT_TYPE(gh_symbol_p(sym), sym, SCM_ARG2, __FUNCTION__, "symbol"); - - return sc->internal_get_grob_property (sym); -} void @@ -932,74 +758,77 @@ Grob::discretionary_processing () { } - -LY_DEFINE(spanner_get_bound, "ly-get-spanner-bound", 2 , 0, 0, - (SCM slur, SCM dir), - "Get one of the bounds of @var{spanner}. @var{dir} may be @code{-1} for -left, and @code{1} for right. -") -{ - Spanner * sl = dynamic_cast (unsmob_grob (slur)); - SCM_ASSERT_TYPE(sl, slur, SCM_ARG1, __FUNCTION__, "spanner grob"); - SCM_ASSERT_TYPE(ly_dir_p (dir), slur, SCM_ARG2, __FUNCTION__, "dir"); - return sl->get_bound (to_dir (dir))->self_scm (); -} - -LY_DEFINE(ly_get_paper_var,"ly-get-paper-variable", 2, 0, 0, - (SCM grob, SCM sym), - "Get a variable from the \\paper block.") +bool +Grob::internal_has_interface (SCM k) { - Grob * sc = unsmob_grob (grob); - SCM_ASSERT_TYPE(sc, grob, SCM_ARG1, __FUNCTION__, "grob"); - SCM_ASSERT_TYPE(gh_symbol_p(sym), sym, SCM_ARG2, __FUNCTION__, "symbol"); + SCM ifs = get_grob_property ("interfaces"); - return sc->paper_l() ->get_scmvar_scm (sym); + return scm_memq (k, ifs) != SCM_BOOL_F; } - -LY_DEFINE(ly_get_extent, "ly-get-extent", 3, 0, 0, - (SCM grob, SCM refp, SCM axis), - "Get the extent in @var{axis} direction of @var{grob} relative to the -grob @var{refp}") +/** Return Array of Grobs in SCM list L */ +Link_array +ly_scm2grobs (SCM l) { - Grob * sc = unsmob_grob (grob); - Grob * ref = unsmob_grob (refp); - SCM_ASSERT_TYPE(sc, grob, SCM_ARG1, __FUNCTION__, "grob"); - SCM_ASSERT_TYPE(ref, refp, SCM_ARG2, __FUNCTION__, "grob"); - - SCM_ASSERT_TYPE(ly_axis_p(axis), axis, SCM_ARG3, __FUNCTION__, "axis"); + Link_array arr; - return ly_interval2scm ( sc->extent (ref, Axis (gh_scm2int (axis)))); -} - -LY_DEFINE (ly_get_parent, "ly-get-parent", 2, 0, 0, (SCM grob, SCM axis), - "Get the parent of @var{grob}. @var{axis} can be 0 for the X-axis, 1 -for the Y-axis.") -{ - Grob * sc = unsmob_grob (grob); - SCM_ASSERT_TYPE(sc, grob, SCM_ARG1, __FUNCTION__, "grob"); - SCM_ASSERT_TYPE(ly_axis_p(axis), axis, SCM_ARG2, __FUNCTION__, "axis"); + for (SCM s = l; gh_pair_p (s); s = gh_cdr (s)) + { + SCM e = gh_car (s); + arr.push (unsmob_grob (e)); + } - return sc->get_parent (Axis (gh_scm2int (axis)))->self_scm(); + arr.reverse (); + return arr; } - -bool -Grob::internal_has_interface (SCM k) +/** Return SCM list of Grob array A */ +SCM +ly_grobs2scm (Link_array a) { - SCM ifs = get_grob_property ("interfaces"); + SCM s = SCM_EOL; + for (int i = a.size (); i; i--) + s = gh_cons (a[i-1]->self_scm (), s); - return scm_memq (k, ifs) != SCM_BOOL_F; + return s; } -IMPLEMENT_TYPE_P (Grob, "ly-grob?"); + +IMPLEMENT_TYPE_P (Grob, "ly:grob?"); ADD_INTERFACE (Grob, "grob-interface", - "All grobs support this", - "X-offset-callbacks Y-offset-callbacks X-extent-callback molecule cause -Y-extent-callback molecule-callback extra-offset -spacing-procedure -staff-symbol interfaces dependencies extra-extent-X causes meta -layer before-line-breaking-callback after-line-breaking-callback extra-extent-Y minimum-extent-X minimum-extent-Y transparent"); + "In music notation, lots of symbols are related in some way. You can\n" +"think of music notation as a graph where nodes are formed by the\n" +"symbols, and the arcs by their relations. A grob is a node in that\n" +"graph. The directed edges in the graph are formed by references to\n" +"other grobs (i.e. pointers). This big graph of grobs specifies the\n" +"notation problem. The solution of this problem is a description of the\n" +"printout in closed form, i.e. a list of values. These values are\n" +"Stencils.\n" +"\n" +"All grobs have an X and Y-position on the page. These X and Y positions\n" +"are stored in a relative format, so they can easily be combined by\n" +"stacking them, hanging one grob to the side of another, and coupling\n" +"them into a grouping-grob.\n" +"\n" +"Each grob has a reference point (a.k.a. parent): the position of a grob\n" +"is stored relative to that reference point. For example the X-reference\n" +"point of a staccato dot usually is the note head that it applies\n" +"to. When the note head is moved, the staccato dot moves along\n" +"automatically.\n" +"\n" +"A grob is often associated with a symbol, but some grobs do not print\n" +"any symbols. They take care of grouping objects. For example, there is a\n" +"separate grob that stacks staves vertically. The @ref{NoteCollision}\n" +"is also an abstract grob: it only moves around chords, but doesn't print\n" +"anything.\n" +, + "X-offset-callbacks Y-offset-callbacks X-extent-callback stencil cause " +"Y-extent-callback print-function extra-offset spacing-procedure " +"staff-symbol interfaces dependencies X-extent Y-extent extra-X-extent " +"meta layer before-line-breaking-callback " +"after-line-breaking-callback extra-Y-extent minimum-X-extent X-extent Y-extent " +"minimum-Y-extent transparent"); +