2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 2006--2015 Han-Wen Nienhuys
6 LilyPond is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 LilyPond is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
23 #include "articulations.hh"
26 #include "engraver.hh"
28 #include "stream-event.hh"
31 #include "translator.icc"
36 make (guitar-like) tablature note
38 class Fretboard_engraver : public Engraver
42 vector<Stream_event *> note_events_;
43 vector<Stream_event *> tabstring_events_;
44 vector<Stream_event *> fingering_events_;
46 TRANSLATOR_DECLARATIONS (Fretboard_engraver);
49 void stop_translation_timestep ();
50 void process_music ();
51 virtual void derived_mark () const;
52 DECLARE_TRANSLATOR_LISTENER (note);
53 DECLARE_TRANSLATOR_LISTENER (string_number);
54 DECLARE_TRANSLATOR_LISTENER (fingering);
61 Fretboard_engraver::derived_mark () const
63 scm_gc_mark (last_placements_);
66 Fretboard_engraver::Fretboard_engraver ()
69 last_placements_ = SCM_BOOL_F;
72 IMPLEMENT_TRANSLATOR_LISTENER (Fretboard_engraver, note);
74 Fretboard_engraver::listen_note (Stream_event *ev)
76 note_events_.push_back (ev);
79 IMPLEMENT_TRANSLATOR_LISTENER (Fretboard_engraver, string_number);
81 Fretboard_engraver::listen_string_number (Stream_event *ev)
83 tabstring_events_.push_back (ev);
86 IMPLEMENT_TRANSLATOR_LISTENER (Fretboard_engraver, fingering);
88 Fretboard_engraver::listen_fingering (Stream_event *ev)
90 fingering_events_.push_back (ev);
94 Fretboard_engraver::process_music ()
96 if (!note_events_.size ())
99 SCM tab_strings = articulation_list (note_events_,
101 "string-number-event");
102 SCM fingers = articulation_list (note_events_,
105 fret_board_ = make_item ("FretBoard", note_events_[0]->self_scm ());
106 SCM fret_notes = ly_cxx_vector_to_list (note_events_);
107 SCM proc = get_property ("noteToFretFunction");
108 if (ly_is_procedure (proc))
110 context ()->self_scm (),
112 scm_list_2 (tab_strings, fingers),
113 fret_board_->self_scm ());
114 SCM changes = get_property ("chordChanges");
115 SCM placements = fret_board_->get_property ("dot-placement-list");
116 if (to_boolean (changes)
117 && ly_is_equal (last_placements_, placements))
118 fret_board_->set_property ("begin-of-line-visible", SCM_BOOL_T);
120 last_placements_ = placements;
124 Fretboard_engraver::stop_translation_timestep ()
127 note_events_.clear ();
128 tabstring_events_.clear ();
129 fingering_events_.clear ();
132 ADD_TRANSLATOR (Fretboard_engraver,
134 "Generate fret diagram from one or more events of type"
135 " @code{NoteEvent}.",
144 "maximumFretStretch "
146 "noteToFretFunction "
147 "predefinedDiagramTable "