X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Fgrob-property.cc;h=55b06d6dfa2f522052b929b881bf2a974d7609c4;hb=bbd867ad3a65bb46645152041289323e7b5da9a7;hp=84bea0c6bc3f6ace23c055d8275f834fefa30033;hpb=1402d6d957bee7d47e0bddf4c57dd89912182b26;p=lilypond.git diff --git a/lily/grob-property.cc b/lily/grob-property.cc index 84bea0c6bc..55b06d6dfa 100644 --- a/lily/grob-property.cc +++ b/lily/grob-property.cc @@ -3,161 +3,253 @@ */ #include -#include #include "main.hh" -#include "input-smob.hh" +#include "input.hh" #include "pointer-group-interface.hh" #include "misc.hh" #include "paper-score.hh" #include "output-def.hh" #include "spanner.hh" +#include "international.hh" #include "item.hh" #include "misc.hh" #include "item.hh" +#include "program-option.hh" +#include "profile.hh" +#include "simple-closure.hh" +#include "warn.hh" +#include "protected-scm.hh" -SCM -Grob::get_property_alist_chain (SCM def) const +Protected_scm grob_property_callback_stack = SCM_EOL; + +extern bool debug_property_callbacks; + +#ifndef NDEBUG +static void +print_property_callback_stack () { - return scm_list_n (mutable_property_alist_, - immutable_property_alist_, - def, - SCM_UNDEFINED); + int frame = 0; + for (SCM s = grob_property_callback_stack; scm_is_pair (s); s = scm_cdr (s)) + message (_f ("%d: %s", frame++, ly_scm_write_string (scm_car (s)).c_str ())); } +#endif + +static SCM modification_callback = SCM_EOL; +static SCM cache_callback = SCM_EOL; + /* - This special add_thing routine is slightly more efficient than - set_prop (name, cons (thing, get_prop (name))) +FIXME: this should use ly:set-option interface instead. - since it can reuse the handle returned by scm_assq (). */ -// JUNKME. -void -Grob::add_to_list_property (SCM sym, SCM thing) + +LY_DEFINE (ly_set_grob_modification_callback, "ly:set-grob-modification-callback", + 1, 0, 0, (SCM cb), + "Specify a procedure that will be called every time LilyPond" + " modifies a grob property. The callback will receive as" + " arguments the grob that is being modified, the name of the" + " C++ file in which the modification was requested, the line" + " number in the C++ file in which the modification was requested," + " the name of the function in which the modification was" + " requested, the property to be changed, and the new value for" + " the property.") { - SCM handle - = scm_sloppy_assq (sym, mutable_property_alist_); + modification_callback = (ly_is_procedure (cb)) ? cb : SCM_BOOL_F; + return SCM_UNSPECIFIED; +} - if (handle != SCM_BOOL_F) - { - scm_set_cdr_x (handle, scm_cons (thing, scm_cdr (handle))); - } - else - { - /* - There is no mutable prop yet, so create an entry, and put it in front of the - mutable prop list. - */ - handle = scm_sloppy_assq (sym, immutable_property_alist_); - SCM tail = (handle != SCM_BOOL_F) ? scm_cdr (handle) : SCM_EOL; - SCM val = scm_cons (thing, tail); - - mutable_property_alist_ = scm_cons (scm_cons (sym, val), - mutable_property_alist_); - } +LY_DEFINE (ly_set_property_cache_callback, "ly:set-property-cache-callback", + 1, 0, 0, (SCM cb), + "Specify a procedure that will be called whenever lilypond" + " calculates a callback function and caches the result. The" + " callback will receive as arguments the grob whose property it" + " is, the name of the property, the name of the callback that" + " calculated the property, and the new (cached) value of the" + " property.") +{ + cache_callback = (ly_is_procedure (cb)) ? cb : SCM_BOOL_F; + return SCM_UNSPECIFIED; } +void +Grob::instrumented_set_property (SCM sym, SCM v, + char const *file, + int line, + char const *fun) +{ +#ifndef NDEBUG + if (ly_is_procedure (modification_callback)) + scm_apply_0 (modification_callback, + scm_list_n (self_scm (), + scm_from_locale_string (file), + scm_from_int (line), + scm_from_locale_string (fun), + sym, v, SCM_UNDEFINED)); +#else + (void) file; + (void) line; + (void) fun; +#endif + + internal_set_property (sym, v); +} + +SCM +Grob::get_property_alist_chain (SCM def) const +{ + return scm_list_n (mutable_property_alist_, + immutable_property_alist_, + def, + SCM_UNDEFINED); +} extern void check_interfaces_for_property (Grob const *me, SCM sym); void Grob::internal_set_property (SCM sym, SCM v) { -#ifndef NDEBUG - SCM grob_p = ly_lily_module_constant ("ly:grob?"); - SCM grob_list_p = ly_lily_module_constant ("grob-list?"); - SCM type = scm_object_property (sym, ly_symbol2scm ("backend-type?")); - - if (type == grob_p - || type == grob_list_p - || (unsmob_grob (v) && ly_symbol2scm ("cause") != sym)) - { - scm_display (scm_list_2 (sym, type), scm_current_output_port()); - assert (0); - } -#endif + internal_set_value_on_alist (&mutable_property_alist_, + sym, v); +} + +void +Grob::internal_set_value_on_alist (SCM *alist, SCM sym, SCM v) +{ /* Perhaps we simply do the assq_set, but what the heck. */ if (!is_live ()) return; if (do_internal_type_checking_global) { - if (!type_check_assignment (sym, v, ly_symbol2scm ("backend-type?"))) - abort (); + if (!ly_is_procedure (v) + && !is_simple_closure (v) + && v != ly_symbol2scm ("calculation-in-progress")) + type_check_assignment (sym, v, ly_symbol2scm ("backend-type?")); + check_interfaces_for_property (this, sym); } - mutable_property_alist_ = scm_assq_set_x (mutable_property_alist_, sym, v); + *alist = scm_assq_set_x (*alist, sym, v); } -#ifdef DEBUG_PROFILE_ACCESSES -Protected_scm property_lookup_table; -LY_DEFINE(ly_property_lookup_stats, "ly:property-lookup-stats", - 0,0,0, (), - "") +SCM +Grob::internal_get_property_data (SCM sym) const { - return (SCM) property_lookup_table; -} +#ifndef NDEBUG + if (profile_property_accesses) + note_property_access (&grob_property_lookup_table, sym); #endif + + SCM handle = scm_sloppy_assq (sym, mutable_property_alist_); + if (handle != SCM_BOOL_F) + return scm_cdr (handle); + + handle = scm_sloppy_assq (sym, immutable_property_alist_); + + if (do_internal_type_checking_global && scm_is_pair (handle)) + { + SCM val = scm_cdr (handle); + if (!ly_is_procedure (val) && !is_simple_closure (val)) + type_check_assignment (sym, val, ly_symbol2scm ("backend-type?")); + + check_interfaces_for_property (this, sym); + } + + return (handle == SCM_BOOL_F) ? SCM_EOL : scm_cdr (handle); +} SCM Grob::internal_get_property (SCM sym) const { + SCM val = get_property_data (sym); + #ifndef NDEBUG - SCM grob_p = ly_lily_module_constant ("ly:grob?"); - SCM grob_list_p = ly_lily_module_constant ("grob-list?"); - SCM type = scm_object_property (sym, ly_symbol2scm ("backend-type?")); - - if (type == grob_p - || type == grob_list_p) + if (val == ly_symbol2scm ("calculation-in-progress")) { - scm_display (scm_list_2 (sym, type), scm_current_output_port()); - assert (0); + programming_error (_f ("cyclic dependency: calculation-in-progress encountered for #'%s (%s)", + ly_symbol2string (sym).c_str (), + name ().c_str ())); + if (debug_property_callbacks) + { + message ("backtrace: "); + print_property_callback_stack (); + } } #endif + + if (ly_is_procedure (val) + || is_simple_closure (val)) + { + Grob *me = ((Grob*)this); + val = me->try_callback_on_alist (&me->mutable_property_alist_, sym, val); + } + + return val; +} -#ifdef DEBUG_PROFILE_ACCESSES +SCM +Grob::try_callback_on_alist (SCM *alist, SCM sym, SCM proc) +{ + SCM marker = ly_symbol2scm ("calculation-in-progress"); /* - Statistics: which properties are looked up? + need to put a value in SYM to ensure that we don't get a + cyclic call chain. */ - if (scm_hash_table_p (property_lookup_table) != SCM_BOOL_T) - { - property_lookup_table = scm_c_make_hash_table (259); - } + *alist = scm_assq_set_x (*alist, sym, marker); - SCM hashhandle = scm_hashq_get_handle (property_lookup_table, sym); - if (hashhandle == SCM_BOOL_F) +#ifndef NDEBUG + if (debug_property_callbacks) + grob_property_callback_stack = scm_cons (scm_list_3 (self_scm (), sym, proc), grob_property_callback_stack); +#endif + + SCM value = SCM_EOL; + if (ly_is_procedure (proc)) + value = scm_call_1 (proc, self_scm ()); + else if (is_simple_closure (proc)) { - scm_hashq_set_x (property_lookup_table, sym, scm_from_int (0)); - hashhandle = scm_hashq_get_handle (property_lookup_table, sym); + value = evaluate_with_simple_closure (self_scm (), + simple_closure_expression (proc), + false, 0, 0); } - - scm_set_cdr_x (hashhandle, scm_from_int (scm_to_int (scm_cdr (hashhandle)) + 1)); -#endif - - SCM s = scm_sloppy_assq (sym, mutable_property_alist_); - if (s != SCM_BOOL_F) - return scm_cdr (s); - s = scm_sloppy_assq (sym, immutable_property_alist_); - - if (do_internal_type_checking_global && scm_is_pair (s)) +#ifndef NDEBUG + if (debug_property_callbacks) + grob_property_callback_stack = scm_cdr (grob_property_callback_stack); +#endif + + /* + If the function returns SCM_UNSPECIFIED, we assume the + property has been set with an explicit set_property () + call. + */ + if (value == SCM_UNSPECIFIED) { - if (!type_check_assignment (sym, scm_cdr (s), - ly_symbol2scm ("backend-type?"))) - abort (); - - check_interfaces_for_property (this, sym); + value = get_property_data (sym); + assert (value == SCM_EOL || value == marker); + if (value == marker) + *alist = scm_assq_remove_x (*alist, marker); } - - return (s == SCM_BOOL_F) ? SCM_EOL : scm_cdr (s); + else + { +#ifndef NDEBUG + if (ly_is_procedure (cache_callback)) + scm_apply_0 (cache_callback, + scm_list_n (self_scm (), + sym, + proc, + value, + SCM_UNDEFINED)); +#endif + internal_set_value_on_alist (alist, sym, value); + } + + return value; } - - void Grob::internal_set_object (SCM s, SCM v) { @@ -168,23 +260,54 @@ Grob::internal_set_object (SCM s, SCM v) object_alist_ = scm_assq_set_x (object_alist_, s, v); } +void +Grob::internal_del_property (SCM sym) +{ + mutable_property_alist_ = scm_assq_remove_x (mutable_property_alist_, sym); +} + SCM Grob::internal_get_object (SCM sym) const { + if (profile_property_accesses) + note_property_access (&grob_property_lookup_table, sym); + SCM s = scm_sloppy_assq (sym, object_alist_); + + if (s != SCM_BOOL_F) + { + SCM val = scm_cdr (s); + if (ly_is_procedure (val) + || is_simple_closure (val)) + { + Grob *me = ((Grob*)this); + val = me->try_callback_on_alist (&me->object_alist_, sym, val); + } + + return val; + } - return (s == SCM_BOOL_F) ? SCM_EOL : scm_cdr (s); + return SCM_EOL; } -void -Grob::substitute_object_links (SCM crit, SCM orig) +bool +Grob::is_live () const { - set_break_subsititution (crit); - object_alist_ = substitute_object_alist (orig, object_alist_); + return scm_is_pair (immutable_property_alist_); } bool -Grob::is_live () const +Grob::internal_has_interface (SCM k) { - return immutable_property_alist_ != SCM_EOL; + return scm_c_memq (k, interfaces_) != SCM_BOOL_F; } + +SCM +call_pure_function (SCM unpure, SCM args, int start, int end) +{ + SCM scm_call_pure_function = ly_lily_module_constant ("call-pure-function"); + + return scm_apply_0 (scm_call_pure_function, + scm_list_4 (unpure, args, scm_from_int (start), scm_from_int (end))); +} +