]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/dynamic-engraver.cc
release: 1.5.29
[lilypond.git] / lily / dynamic-engraver.cc
index 833e40c83b8982268254e0ae7f2fdc3371b9f501..a021d21fdfb36324b1295ddb34272cd040be9d16 100644 (file)
 /*
-  dynamic-reg.cc -- implement Dynamic_engraver
+  dynamic-engraver.cc -- implement Dynamic_engraver
 
   source file of the GNU LilyPond music typesetter
 
-  (c)  1997--1999 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+  (c)  1997--2002 Han-Wen Nienhuys <hanwen@cs.uu.nl>
 */
 #include "debug.hh"
-#include "crescendo.hh"
-#include "dynamic-engraver.hh"
+#include "dimensions.hh"
+#include "hairpin.hh"
 #include "musical-request.hh"
-#include "lookup.hh"
-#include "paper-def.hh"
-#include "score-column.hh"
-#include "staff-symbol.hh"
+#include "paper-column.hh"
 #include "note-column.hh"
-#include "text-item.hh"
-#include "staff-side.hh"
+#include "item.hh"
+#include "side-position-interface.hh"
 #include "engraver.hh"
-#include "stem.hh"
-#include "note-head.hh"
+#include "group-interface.hh"
+#include "directional-element-interface.hh"
+#include "translator-group.hh"
+#include "axis-group-interface.hh"
+
+
+/*
+  TODO:
+
+  * direction of text-dynamic-request if not equal to direction of
+  line-spanner
+
+  - TODO: this engraver is too complicated. We should split it into
+  the handling of the basic grobs and the  linespanner
+
+  - TODO: the line-spanner is not killed after the (de)crescs are
+  finished.
+
+*/
 
 /**
    print text & hairpin dynamics.
  */
 class Dynamic_engraver : public Engraver
 {
-  Text_item * text_p_;
-  Staff_side_item * staff_side_p_;
-  Staff_side_spanner * ss_span_p_;
-  Staff_side_spanner * to_end_ss_span_p_;
+  Item * script_p_;
+  Spanner * finished_cresc_p_;
+  Spanner * cresc_p_;
+
+  Text_script_req* script_req_l_;
   
+  Span_req * current_cresc_req_;
+  Drul_array<Span_req*> accepted_spanreqs_drul_;
+
+  Spanner* line_spanner_;
+  Spanner* finished_line_spanner_;
+
+  Link_array<Note_column> pending_column_arr_;
+  Link_array<Grob> pending_element_arr_;
   
-  Crescendo * to_end_cresc_p_;
-  Crescendo * cresc_p_;
-  Span_req * cresc_req_l_;
-  Array<Request*> dynamic_req_l_arr_;
-  void  typeset_all ();
-public:
-  VIRTUAL_COPY_CONS(Translator);
-  Dynamic_engraver();
+  void typeset_all ();
+
+TRANSLATOR_DECLARATIONS(Dynamic_engraver );
   
 protected:
-  virtual void do_removal_processing ();
-  virtual void acknowledge_element (Score_element_info);
-  virtual bool do_try_music (Music *req_l);
-  virtual void do_process_requests();
-  virtual void do_pre_move_processing();
-  virtual void do_post_move_processing();
+  virtual void finalize ();
+  virtual void acknowledge_grob (Grob_info);
+  virtual bool try_music (Music *req_l);
+  virtual void stop_translation_timestep ();
+  virtual void process_music ();  
+  virtual void start_translation_timestep ();
 };
 
 
 
-Dynamic_engraver::Dynamic_engraver()
+
+Dynamic_engraver::Dynamic_engraver ()
 {
-  do_post_move_processing();
-  text_p_ =0;
-  staff_side_p_ =0;
-  to_end_cresc_p_ = cresc_p_ = 0;
-  ss_span_p_ = to_end_ss_span_p_=0;
-  cresc_req_l_ = 0;
+  script_p_ = 0;
+  finished_cresc_p_ = 0;
+  line_spanner_ = 0;
+  finished_line_spanner_ = 0;
+  current_cresc_req_ = 0;
+  cresc_p_ =0;
+
+  script_req_l_ = 0;
+  accepted_spanreqs_drul_[START] = 0;
+  accepted_spanreqs_drul_[STOP] = 0;
 }
 
 void
-Dynamic_engraver::do_post_move_processing()
+Dynamic_engraver::start_translation_timestep ()
 {
-  dynamic_req_l_arr_.clear();
+  script_req_l_ = 0;
+  accepted_spanreqs_drul_[START] = 0;
+  accepted_spanreqs_drul_[STOP] = 0;
 }
 
 bool
-Dynamic_engraver::do_try_music (Music * m)
+Dynamic_engraver::try_music (Music * m)
 {
-  Request * r = dynamic_cast<Request*> (m);
-
-  if(Text_script_req * d = dynamic_cast <Text_script_req *> (r))
+  if (dynamic_cast <Text_script_req*> (m)
+      && m->get_mus_property ("text-type") == ly_symbol2scm ("dynamic"))
     {
-      if (d->style_str_ != "dynamic")
-       return false;
+      script_req_l_ = dynamic_cast<Text_script_req*> (m);
+      return true;
     }
-  else if (Span_req * s =  dynamic_cast <Span_req*> (r))
+  else if (Span_req* s =  dynamic_cast <Span_req*> (m))
     {
-      if (s-> span_type_str_ != "crescendo"
-         && s->span_type_str_ != "decrescendo")
-       return false;
+      String t = ly_scm2string (s->get_mus_property ("span-type"));
+      if (t== "abort")
+       {
+         accepted_spanreqs_drul_[LEFT] = 0;
+         accepted_spanreqs_drul_[RIGHT] = 0;
+         /*
+           Let's not kill the line spanner, since that would fuck up
+           earlier, not-to-be-terminated stuff.
+
+           It will disappear by itself when stop_translation_timestep
+ () finds that there is nothing to support anymore.  */
+         
+         if (cresc_p_)
+           cresc_p_->suicide ();
+         cresc_p_ = 0;
+       }
+      else if (t == "crescendo"
+          || t == "decrescendo")
+       {
+         accepted_spanreqs_drul_[s->get_span_dir ()] = s;
+         return true;
+       }
     }
-  else
-    return false;
-  
-  for (int i=0; i < dynamic_req_l_arr_.size (); i++)
-    if (r->equal_b (dynamic_req_l_arr_[i]))
-      return true;
-  
-  dynamic_req_l_arr_.push (r);
-  return true;
+  return false;
 }
 
-
 void
-Dynamic_engraver::do_process_requests()
+Dynamic_engraver::process_music ()
 {
-  Crescendo*  new_cresc_p=0;
-  Staff_side_spanner * new_sss_p =0;
-  for (int i=0; i < dynamic_req_l_arr_.size(); i++)
+  if (accepted_spanreqs_drul_[START] || accepted_spanreqs_drul_[STOP] || script_req_l_)
     {
-      if (Text_script_req *absd =
-         dynamic_cast<Text_script_req *> ( dynamic_req_l_arr_[i]))
+      if (!line_spanner_)
        {
-         if (text_p_)
-           {
-             dynamic_req_l_arr_[i]->warning (_("Got a dynamic already.  Continuing dazed and confused"));
-             continue;
-           }
-         
-         String loud = absd->text_str_;
+         line_spanner_ = new Spanner (get_property ("DynamicLineSpanner"));
 
-         text_p_ = new Text_item;
-         text_p_->text_str_ =  loud; // ugh
-         Scalar prop = get_property ("dynamicStyle", 0);
+         Side_position_interface::set_axis (line_spanner_, Y_AXIS);
+         Axis_group_interface::set_interface (line_spanner_);
+         Axis_group_interface::set_axes (line_spanner_, Y_AXIS, Y_AXIS);
 
-         text_p_->style_str_ = prop.length_i () ? prop :  "dynamic";
+         Music * rq = accepted_spanreqs_drul_[START];
+         if (script_req_l_)
+           rq =  script_req_l_ ;
+         announce_grob (line_spanner_, rq);
+                        
 
-         staff_side_p_ = new Staff_side_item;
-         staff_side_p_->set_elt_property (script_priority_scm_sym,
-                                          gh_int2scm (100));
-                                          
-         staff_side_p_->set_victim (text_p_);
-         staff_side_p_->axis_ = Y_AXIS;
-         
+       }
+    }
+  
+       /*
+       During a (de)crescendo, pending request will not be cleared,
+       and a line-spanner will always be created, as \< \! are already
+       two requests.
 
-         prop = get_property ("dynamicDir", 0);
-         if (prop.isnum_b ())
-           {
-             staff_side_p_->dir_ = (Direction) (int) prop;
-           }
+       Note: line-spanner must always have at least same duration
+       as (de)crecsendo, b.o. line-breaking.
+       */
+
+  
+
+  /*
+    maybe we should leave dynamic texts to the text-engraver and
+    simply acknowledge them?
+  */
+  if (script_req_l_)
+    {
+      script_p_ = new Item (get_property ("DynamicText"));
+      script_p_->set_grob_property ("text",
+                                  script_req_l_->get_mus_property ("text"));
+      
+      Side_position_interface::set_direction (script_p_, DOWN);
+
+      if (Direction d = script_req_l_->get_direction ())
+       Directional_element_interface::set (line_spanner_, d);
 
-     prop = get_property ("dynamicPadding", 0);
-         if (prop.isnum_b ())
-           {
-             staff_side_p_->set_elt_property (padding_scm_sym, 
-                                              gh_double2scm(Real(prop)));
-           }
-         announce_element (Score_element_info (text_p_, absd));
-         announce_element (Score_element_info (staff_side_p_, absd));
+      Axis_group_interface::add_element (line_spanner_, script_p_);
+
+      announce_grob (script_p_, script_req_l_);
+    }
+
+  if (accepted_spanreqs_drul_[STOP])
+    {
+      /*
+       finish side position alignment if the (de)cresc ends here, and
+       there are no new dynamics.
+       */
+      if (!cresc_p_)
+       {
+         accepted_spanreqs_drul_[STOP]->origin ()->warning
+ (_ ("can't find start of (de)crescendo"));
+         accepted_spanreqs_drul_[STOP] = 0;
        }
-      else if (Span_req *span_l
-                      = dynamic_cast <Span_req *> (dynamic_req_l_arr_[i]))
+      else
        {
-         if (span_l->span_dir_ == STOP)
-           {
-             if (!cresc_p_)
-               {
-                 span_l->warning (_ ("can't find (de)crescendo to end"));
-               }
-             else
-               {
-                 assert (!to_end_cresc_p_);
-                 to_end_cresc_p_ =cresc_p_;
-                 to_end_ss_span_p_ = ss_span_p_ ;
-                 
-                 cresc_p_ = 0;
-                 ss_span_p_ =0;
-                 Scalar prop = get_property ("dynamicDir", 0);
-                 if (prop.isnum_b ())
-                   {
-                     to_end_ss_span_p_->dir_ = (Direction) (int) prop;
-                   }
-                 
-               }
-           }
-         else if (span_l->span_dir_ == START)
-           {
-             cresc_req_l_ = span_l;
-             assert (!new_cresc_p);
-             new_cresc_p  = new Crescendo;
-             new_cresc_p->grow_dir_ = (span_l->span_type_str_ == "crescendo")  ? BIGGER : SMALLER;
-             announce_element (Score_element_info (new_cresc_p, span_l));
-
-             new_sss_p = new Staff_side_spanner;
-             new_sss_p->set_victim (new_cresc_p);
-             new_sss_p->axis_ = Y_AXIS;
-             announce_element (Score_element_info (new_sss_p, span_l));
-           }
+         assert (!finished_cresc_p_ && cresc_p_);
+
+         cresc_p_->set_bound (RIGHT, script_p_
+                              ? script_p_
+                              : unsmob_grob (get_property ("currentMusicalColumn")));
+         add_bound_item (line_spanner_, cresc_p_->get_bound (RIGHT));
+         
+
+         finished_cresc_p_ = cresc_p_;
+         cresc_p_ = 0;
+         current_cresc_req_ = 0;
        }
     }
-
-  if (new_cresc_p)
+  
+  if (accepted_spanreqs_drul_[START])
     {
-      if (cresc_p_)
+      if (current_cresc_req_)
        {
-         ::warning (_ ("Too many crescendi here"));
-         typeset_element (cresc_p_);
-         typeset_element (ss_span_p_);
-         cresc_p_ = 0;
-         ss_span_p_ =0;
+         accepted_spanreqs_drul_[START]->origin ()->warning
+ (current_cresc_req_->get_span_dir () == 1
+            ? _ ("already have a crescendo")
+            : _ ("already have a decrescendo"));
        }
-      
-      cresc_p_ = new_cresc_p;
-      ss_span_p_ = new_sss_p;
-      cresc_p_->set_bounds(LEFT,get_staff_info().musical_pcol_l ());
-      ss_span_p_->set_bounds (LEFT,get_staff_info().musical_pcol_l ());
-      if (text_p_)
+      else
        {
-         cresc_p_->dyn_b_drul_[LEFT] = true;
-         if (to_end_cresc_p_)
-           to_end_cresc_p_->dyn_b_drul_[RIGHT] = true;
+         current_cresc_req_ = accepted_spanreqs_drul_[START];
+
+         /*
+           TODO: Use symbols.
+         */
+
+         String start_type = ly_scm2string (accepted_spanreqs_drul_[START]->get_mus_property ("span-type"));
+
+         /*
+           ugh. Use push/pop?
+         */
+         SCM s = get_property ((start_type + "Spanner").ch_C ());
+         if (!gh_symbol_p (s) || s == ly_symbol2scm ("hairpin"))
+           {
+             cresc_p_  = new Spanner (get_property ("Hairpin"));
+             cresc_p_->set_grob_property ("grow-direction",
+                                          gh_int2scm ((start_type == "crescendo")
+                                                      ? BIGGER : SMALLER));
+             
+           }
+         /*
+           This is a convenient (and legacy) interface to TextSpanners
+           for use in (de)crescendi.
+           Hmm.
+         */
+         else
+           {
+             cresc_p_  = new Spanner (get_property ("TextSpanner"));
+             cresc_p_->set_interface (ly_symbol2scm ("dynamic-interface"));
+             cresc_p_->set_grob_property ("type", s);
+             
+             daddy_trans_l_->set_property ((start_type
+                                           + "Spanner").ch_C(), SCM_UNDEFINED);
+             s = get_property ((start_type + "Text").ch_C ());
+             /*
+               FIXME: use markup_p () to check type.
+             */
+             if (gh_string_p (s) || gh_pair_p (s))
+               {
+                 cresc_p_->set_grob_property ("edge-text",
+                                              gh_cons (s, ly_str02scm ("")));
+                 daddy_trans_l_->set_property ((start_type + "Text").ch_C(),
+                                               SCM_UNDEFINED);
+               }
+           }
+
+         cresc_p_->set_bound (LEFT, script_p_
+                              ? script_p_
+                              : unsmob_grob (get_property ("currentMusicalColumn")));
+
+         Axis_group_interface::add_element (line_spanner_, cresc_p_);
+
+         add_bound_item (line_spanner_, cresc_p_->get_bound (LEFT));
+         
+         announce_grob (cresc_p_, accepted_spanreqs_drul_[START]);
        }
     }
 }
 
 void
-Dynamic_engraver::do_pre_move_processing()
+Dynamic_engraver::stop_translation_timestep ()
 {
   typeset_all ();
+  if (script_req_l_ && !current_cresc_req_)
+    {
+      finished_line_spanner_ = line_spanner_;
+      line_spanner_ =0;
+      typeset_all ();
+    }
 }
 
-
-
-ADD_THIS_TRANSLATOR(Dynamic_engraver);
-
 void
-Dynamic_engraver::do_removal_processing ()
+Dynamic_engraver::finalize ()
 {
+  typeset_all ();
+  
+  if (line_spanner_
+      && line_spanner_->immutable_property_alist_ == SCM_EOL)
+    line_spanner_ = 0;
+  if (line_spanner_)
+    {
+      finished_line_spanner_ = line_spanner_;
+      typeset_all ();
+    }
+
+  if (cresc_p_
+      && cresc_p_->immutable_property_alist_ == SCM_EOL)
+    cresc_p_ = 0;
   if (cresc_p_)
     {
-      typeset_element (cresc_p_ );
-      typeset_element (ss_span_p_);
-      ss_span_p_ =0;
-      cresc_req_l_->warning (_ ("unended crescendo"));
-      cresc_p_ =0;
+      current_cresc_req_->origin ()->warning (_ ("unterminated (de)crescendo"));
+      cresc_p_->suicide ();
+      cresc_p_ = 0;
     }
-  typeset_all ();
 }
 
-
 void
 Dynamic_engraver::typeset_all ()
 {  
-  if (to_end_cresc_p_)
+  /*
+    remove suicided spanners,
+    ugh: we'll need this for every spanner, beam, slur
+    Hmm, how to do this, cleanly?
+    Maybe just check at typeset_grob ()?
+  */
+  if (finished_cresc_p_
+      && finished_cresc_p_->immutable_property_alist_ == SCM_EOL)
+    finished_cresc_p_ = 0;
+  if (finished_line_spanner_
+      && finished_line_spanner_->immutable_property_alist_ == SCM_EOL)
+    finished_line_spanner_ = 0;
+
+  if (finished_cresc_p_)
     {
-      to_end_cresc_p_->set_bounds(RIGHT,get_staff_info().musical_pcol_l ());
-      to_end_ss_span_p_->set_bounds(RIGHT,get_staff_info().musical_pcol_l ());
-      typeset_element (to_end_cresc_p_);
-      typeset_element (to_end_ss_span_p_);
-      to_end_cresc_p_ =0;
-      to_end_ss_span_p_ =0;
+      if (!finished_cresc_p_->get_bound (RIGHT))
+       {
+         finished_cresc_p_->set_bound (RIGHT, script_p_
+                                       ? script_p_
+                                       : unsmob_grob (get_property ("currentMusicalColumn")));
+
+         if (finished_line_spanner_)
+           add_bound_item (finished_line_spanner_,
+                           finished_cresc_p_->get_bound (RIGHT));
+       }
+      typeset_grob (finished_cresc_p_);
+      finished_cresc_p_ =0;
     }
   
-  if (text_p_)
+  if (script_p_)
     {
-      typeset_element (text_p_);
-      typeset_element (staff_side_p_);
-      text_p_ =0;
-      staff_side_p_ =0;
+      typeset_grob (script_p_);
+      script_p_ = 0;
     }
-}
+  if (finished_line_spanner_)
+    {
+      /* To make sure that this works */
+      Side_position_interface::add_staff_support (finished_line_spanner_);
+      
+      /*
+       We used to have
+       
+            extend_spanner_over_elements (finished_line_spanner_);
+
+       but this is rather kludgy, since finished_line_spanner_
+       typically has a staff-symbol field set , extending it over the
+       entire staff.
 
+      */
+
+      Grob * l = finished_line_spanner_->get_bound (LEFT );
+      Grob * r = finished_line_spanner_->get_bound (RIGHT);      
+      if (!r && l)
+       finished_line_spanner_->set_bound (RIGHT, l);
+      else if (!l && r)
+       finished_line_spanner_->set_bound (LEFT, r);
+      else if (!r && !l)
+       {
+         /*
+           This is a isolated dynamic apparently, and does not even have
+           any interesting support item.
+          */
+         Grob * cc = unsmob_grob (get_property ("currentMusicalColumn"));
+         Item * ci = dynamic_cast<Item*>(cc);
+         finished_line_spanner_->set_bound (RIGHT, ci);
+         finished_line_spanner_->set_bound (LEFT, ci);   
+       }
+       
+      typeset_grob (finished_line_spanner_);
+      finished_line_spanner_ = 0;
+    }
+}
 
 void
-Dynamic_engraver::acknowledge_element (Score_element_info i)
+Dynamic_engraver::acknowledge_grob (Grob_info i)
 {
-  if (dynamic_cast<Stem *> (i.elem_l_)
-      || dynamic_cast<Note_head *> (i.elem_l_)
-      )
+  if (Note_column::has_interface (i.grob_l_))
     {
-      if (staff_side_p_)
-       staff_side_p_->add_support (i.elem_l_);
-
-      if (to_end_ss_span_p_)
-       to_end_ss_span_p_->add_support (i.elem_l_);
-
-      if (ss_span_p_)
-       ss_span_p_->add_support (i.elem_l_);
+      if (line_spanner_
+         /* Don't refill killed spanner */
+         && line_spanner_->immutable_property_alist_ != SCM_EOL)
+       {
+         Side_position_interface::add_support (line_spanner_,i.grob_l_);
+         add_bound_item (line_spanner_,dynamic_cast<Item*> (i.grob_l_));
+       }
     }
 }
+ENTER_DESCRIPTION(Dynamic_engraver,
+/* descr */       "",
+/* creats*/       "DynamicLineSpanner DynamicText Hairpin TextSpanner",
+/* acks  */       "note-column-interface",
+/* reads */       "",
+/* write */       "");