source file of the GNU LilyPond music typesetter
- (c) 1997--2001 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+ (c) 1997--2003 Han-Wen Nienhuys <hanwen@cs.uu.nl>
*/
#include "paper-score.hh"
-#include "debug.hh"
+#include "warn.hh"
#include "item.hh"
#include "paper-column.hh"
#include "spanner.hh"
#include "lily-guile.hh"
-#include "line-of-score.hh"
+#include "system.hh"
+#include "group-interface.hh"
Item::Item (SCM s)
: Grob (s)
{
broken_to_drul_[LEFT] = broken_to_drul_[RIGHT]=0;
+ Group_interface::add_thing (this, ly_symbol2scm ("interfaces"), ly_symbol2scm ("item-interface"));
}
/**
bool
Item::breakable_b (Grob*me)
{
- if (me->original_l_)
+ if (me->original_)
return false;
if (!dynamic_cast<Item*> (me))
- programming_error ("only items can be breakable.");
+ me->programming_error ("only items can be breakable.");
Item * i =dynamic_cast<Item*> (me->get_parent (X_AXIS));
return (i) ? Item::breakable_b (i) : to_boolean (me->get_grob_property ("breakable"));
}
Paper_column *
-Item::column_l () const
+Item::get_column () const
{
Item *parent = dynamic_cast<Item*> (get_parent (X_AXIS));
- return parent ? parent->column_l () : 0;
+ return parent ? parent->get_column () : 0;
}
-Line_of_score *
-Item::line_l () const
+System *
+Item::get_system () const
{
Grob *g = get_parent (X_AXIS);
- return g ? g->line_l () : 0;
+ return g ? g->get_system () : 0;
}
do
{
Grob * dolly = clone ();
- Item * item_p = dynamic_cast<Item*> (dolly);
- pscore_l_->line_l_->typeset_grob (item_p);
- new_copies[i] =item_p;
+ Item * item = dynamic_cast<Item*> (dolly);
+ pscore_->system_->typeset_grob (item);
+ new_copies[i] =item;
}
while (flip (&i) != LEFT);
broken_to_drul_= new_copies;
}
Grob*
-Item::find_broken_piece (Line_of_score*l) const
+Item::find_broken_piece (System*l) const
{
- if (line_l () == l)
+ if (get_system () == l)
return (Item*) (this);
Direction d = LEFT;
do {
Grob *s = broken_to_drul_[d];
- if (s && s->line_l () == l)
+ if (s && s->get_system () == l)
return s;
}
while (flip (&d) != LEFT);
Direction
Item::break_status_dir () const
{
- if (original_l_)
+ if (original_)
{
- Item * i = dynamic_cast<Item*> (original_l_);
+ Item * i = dynamic_cast<Item*> (original_);
return (i->broken_to_drul_[LEFT] == this) ? LEFT : RIGHT;
}
void
Item::handle_prebroken_dependencies ()
{
- if (original_l_)
- {
- mutable_property_alist_
- = handle_broken_grobs(original_l_->mutable_property_alist_,
- gh_int2scm (break_status_dir ()));
- }
+ Grob::handle_prebroken_dependencies ();
/*
Can't do this earlier, because try_visibility_lambda () might set
TODO:
- handle visibility-lambda the item itself iso. breakstatusdir, so
- the function can do more complicated things.
-
+ give the item to break-visibility itself, so the function can do
+ more complicated things.
*/
- SCM vis = get_grob_property ("visibility-lambda");
+ SCM vis = get_grob_property ("break-visibility");
if (gh_procedure_p (vis))
{
SCM args = scm_list_n (gh_int2scm (break_status_dir ()), SCM_UNDEFINED);
suicide ();
else if (empty)
{
- set_extent_callback (SCM_EOL, X_AXIS);
- set_extent_callback (SCM_EOL, Y_AXIS);
+ set_extent (SCM_EOL, X_AXIS);
+ set_extent (SCM_EOL, Y_AXIS);
}
else if (trans)
- set_grob_property ("molecule-callback", SCM_BOOL_T);
+ set_grob_property ("molecule-callback", SCM_EOL);
}
}
SCM
-Item::do_derived_mark ()
+Item::do_derived_mark ()const
{
if (broken_to_drul_[LEFT])
scm_gc_mark (broken_to_drul_[LEFT]->self_scm ());
{
return dynamic_cast<Item*> (unsmob_grob (s));
}
+
+
+
+ADD_INTERFACE(Item,
+ "item-interface",
+ "\n"
+ "\n"
+ "Grobs can be distinguished in their role in the horizontal spacing.\n"
+ "Many grobs define constraints on the spacing by their sizes. For\n"
+ "example, note heads, clefs, stems, and all other symbols with a fixed\n"
+ "shape. These grobs form a subtype called @code{Item}.\n"
+ "\n"
+ "\n"
+ "Some items need special treatment for line breaking. For example, a\n"
+ "clef is normally only printed at the start of a line (i.e. after a\n"
+ "line break). To model this, `breakable' items (clef, key signature,\n"
+ "bar lines, etc.) are copied twice. Then we have three versions of each\n"
+ "breakable item: one version if there is no line break, one version\n"
+ "that is printed before the line break (at the end of a system), one\n"
+ "version that is printed after the line break.\n"
+ "\n"
+ "Whether these versions are visible and take up space, is determined by\n"
+ "the outcome of the @code{break-visibility}. This grob property is a\n"
+ "function taking a direction (-1, 0 or 1) as argument. It returns a\n"
+ "cons of booleans, signifying whether this grob should be transparent\n"
+ "and have no extent.\n",
+ "no-spacing-rods break-visibility breakable")