/*
- dynamic-performer.cc -- implement Dynamic_performer
+ This file is part of LilyPond, the GNU music typesetter.
- source file of the GNU LilyPond music typesetter
+ Copyright (C) 2000--2015 Jan Nieuwenhuizen <janneke@gnu.org>
- (c) 2000--2004 Jan Nieuwenhuizen <janneke@gnu.org>
+ LilyPond is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ LilyPond is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
*/
#include "performer.hh"
-
-#include "event.hh"
#include "audio-item.hh"
+#include "stream-event.hh"
+#include "international.hh"
-/*
- TODO:
-
- handle multiple events
+#include "translator.icc"
- perform absolute (text) dynamics
- */
class Dynamic_performer : public Performer
{
public:
- TRANSLATOR_DECLARATIONS(Dynamic_performer);
+ TRANSLATOR_DECLARATIONS (Dynamic_performer);
protected:
- virtual bool try_music (Music* req);
- virtual void stop_translation_timestep ();
- virtual void create_audio_elements ();
+ void stop_translation_timestep ();
+ void process_music ();
+ Real equalize_volume (Real);
+ DECLARE_TRANSLATOR_LISTENER (decrescendo);
+ DECLARE_TRANSLATOR_LISTENER (crescendo);
+ DECLARE_TRANSLATOR_LISTENER (absolute_dynamic);
private:
- Music* script_req_;
- Audio_dynamic* audio_;
+ Stream_event *script_event_;
+ Drul_array<Stream_event *> span_events_;
+ Drul_array<Direction> grow_dir_;
+ Real last_volume_;
+ bool last_volume_initialized_;
+ Audio_dynamic *absolute_;
+ Audio_span_dynamic *span_dynamic_;
+ Audio_span_dynamic *finished_span_dynamic_;
};
Dynamic_performer::Dynamic_performer ()
{
- script_req_ = 0;
- audio_ = 0;
+ last_volume_ = 0.0;
+ last_volume_initialized_ = false;
+ script_event_ = 0;
+ absolute_ = 0;
+ span_events_[LEFT]
+ = span_events_[RIGHT] = 0;
+ span_dynamic_ = 0;
+ finished_span_dynamic_ = 0;
+}
+
+Real
+Dynamic_performer::equalize_volume (Real volume)
+{
+ /*
+ properties override default equaliser setting
+ */
+ SCM min = get_property ("midiMinimumVolume");
+ SCM max = get_property ("midiMaximumVolume");
+ if (scm_is_number (min) || scm_is_number (max))
+ {
+ Interval iv (0, 1);
+ if (scm_is_number (min))
+ iv[MIN] = scm_to_double (min);
+ if (scm_is_number (max))
+ iv[MAX] = scm_to_double (max);
+ volume = iv[MIN] + iv.length () * volume;
+ }
+ else
+ {
+ /*
+ urg, code duplication:: staff_performer
+ */
+ SCM s = get_property ("midiInstrument");
+
+ if (!scm_is_string (s))
+ s = get_property ("instrumentName");
+
+ if (!scm_is_string (s))
+ s = scm_from_locale_string ("piano");
+
+ SCM eq = get_property ("instrumentEqualizer");
+ if (ly_is_procedure (eq))
+ s = scm_call_1 (eq, s);
+
+ if (is_number_pair (s))
+ {
+ Interval iv = ly_scm2interval (s);
+ volume = iv[MIN] + iv.length () * volume;
+ }
+ }
+ return volume;
}
void
-Dynamic_performer::create_audio_elements ()
+Dynamic_performer::process_music ()
{
- if (script_req_)
+ if (span_events_[STOP] || script_event_)
{
- SCM proc = get_property ("dynamicAbsoluteVolumeFunction");
+ // End of a dynamic spanner, or an explicit dynamic script event.
+ finished_span_dynamic_ = span_dynamic_;
+ span_dynamic_ = 0;
+ }
- SCM svolume = SCM_EOL;
- if (gh_procedure_p (proc))
- {
- // urg
- svolume = gh_call1 (proc, script_req_->get_property ("text"));
- }
+ if (span_events_[START])
+ {
+ // Start of a dynamic spanner. Create a new Audio_span_dynamic for
+ // collecting changes in dynamics within this spanner.
+ span_dynamic_ = new Audio_span_dynamic (equalize_volume (0.1), equalize_volume (1.0));
+ announce_element (Audio_element_info (span_dynamic_, span_events_[START]));
+
+ span_dynamic_->grow_dir_ = grow_dir_[START];
+
+ if (!last_volume_initialized_ && !script_event_)
+ {
+ // No explicit dynamic script events have occurred yet, but there is
+ // nevertheless a dynamic spanner. Initialize last_volume_ to a
+ // value within the available range.
+ span_events_[START]->origin ()->warning (_ ("(De)crescendo with unspecified starting volume in MIDI."));
+ last_volume_ = equalize_volume (0.5);
+ last_volume_initialized_ = true;
+ }
+ }
- Real volume = robust_scm2double (svolume, 0.5);
+ if (script_event_
+ || span_dynamic_
+ || finished_span_dynamic_)
+ {
+ // New change in dynamics.
+ absolute_ = new Audio_dynamic ();
- /*
- properties override default equaliser setting
- */
- SCM min = get_property ("midiMinimumVolume");
- SCM max = get_property ("midiMaximumVolume");
- if (gh_number_p (min) || gh_number_p (max))
- {
- Interval iv (0, 1);
- if (gh_number_p (min))
- iv[MIN] = gh_scm2double (min);
- if (gh_number_p (max))
- iv[MAX] = gh_scm2double (max);
- volume = iv[MIN] + iv.length () * volume;
- }
- else
- {
- /*
- urg, code duplication:: staff_performer
- */
- SCM s = get_property ("midiInstrument");
-
- if (!gh_string_p (s))
- s = get_property ("instrument");
-
- if (!gh_string_p (s))
- s = scm_makfrom0str ("piano");
-
-
- SCM eq = get_property ("instrumentEqualizer");
- if (gh_procedure_p (eq))
- {
- s = gh_call1 (eq, s);
- }
-
- if (is_number_pair (s))
- {
- Interval iv = ly_scm2interval (s);
- volume = iv[MIN] + iv.length () * volume;
- }
- }
-
- audio_ = new Audio_dynamic (volume);
- Audio_element_info info (audio_, script_req_);
+ if (script_event_)
+ {
+ // Explicit dynamic script event: determine the volume.
+ SCM proc = get_property ("dynamicAbsoluteVolumeFunction");
+
+ SCM svolume = SCM_EOL;
+ if (ly_is_procedure (proc))
+ {
+ // urg
+ svolume = scm_call_1 (proc, script_event_->get_property ("text"));
+ }
+
+ Real volume = robust_scm2double (svolume, 0.5);
+
+ last_volume_
+ = absolute_->volume_ = equalize_volume (volume);
+ last_volume_initialized_ = true;
+ }
+
+ Audio_element_info info (absolute_, script_event_);
announce_element (info);
- script_req_ = 0;
}
+
+ if (!last_volume_initialized_)
+ {
+ absolute_ = new Audio_dynamic ();
+
+ last_volume_
+ = absolute_->volume_ = equalize_volume (0.71); // Backward compatible
+ last_volume_initialized_ = true;
+
+ Audio_element_info info (absolute_, script_event_);
+ announce_element (info);
+ }
+
+ if (span_dynamic_)
+ span_dynamic_->add_absolute (absolute_);
+
+ if (finished_span_dynamic_)
+ finished_span_dynamic_->add_absolute (absolute_);
}
void
Dynamic_performer::stop_translation_timestep ()
{
- if (audio_)
+ if (finished_span_dynamic_)
{
- play_element (audio_);
- audio_ = 0;
+ finished_span_dynamic_->render ();
+ finished_span_dynamic_ = 0;
}
-}
-bool
-Dynamic_performer::try_music (Music* r)
-{
- if (!script_req_)
+ if (absolute_ && absolute_->volume_ < 0)
+ {
+ absolute_->volume_ = last_volume_;
+ }
+ else if (absolute_)
{
- if (r->is_mus_type ("absolute-dynamic-event")) // fixme.
- {
- script_req_ = r;
- return true;
- }
+ last_volume_ = absolute_->volume_;
+ last_volume_initialized_ = true;
}
- return false;
+
+ absolute_ = 0;
+ script_event_ = 0;
+ span_events_[LEFT]
+ = span_events_[RIGHT] = 0;
+}
+
+IMPLEMENT_TRANSLATOR_LISTENER (Dynamic_performer, decrescendo);
+void
+Dynamic_performer::listen_decrescendo (Stream_event *r)
+{
+ Direction d = to_dir (r->get_property ("span-direction"));
+ span_events_[d] = r;
+ grow_dir_[d] = SMALLER;
}
-ENTER_DESCRIPTION(Dynamic_performer,
- /*descr*/ "",
- /* creats*/ "",
- /* accepts */ "absolute-dynamic-event",
- /* acks */ "",
- /*reads */"dynamicAbsoluteVolumeFunction midiMaximumVolume midiMinimumVolume midiInstrument instrumentEqualizer",
- /*writes*/"");
+IMPLEMENT_TRANSLATOR_LISTENER (Dynamic_performer, crescendo);
+void
+Dynamic_performer::listen_crescendo (Stream_event *r)
+{
+ Direction d = to_dir (r->get_property ("span-direction"));
+ span_events_[d] = r;
+ grow_dir_[d] = BIGGER;
+}
+
+IMPLEMENT_TRANSLATOR_LISTENER (Dynamic_performer, absolute_dynamic);
+void
+Dynamic_performer::listen_absolute_dynamic (Stream_event *r)
+{
+ if (!script_event_)
+ script_event_ = r;
+}
+
+ADD_TRANSLATOR (Dynamic_performer,
+ /* doc */
+ "",
+
+ /* create */
+ "",
+
+ /* read */
+ "dynamicAbsoluteVolumeFunction "
+ "instrumentEqualizer "
+ "midiMaximumVolume "
+ "midiMinimumVolume "
+ "midiInstrument ",
+
+ /* write */
+ ""
+ );
projects / lilypond.git / blobdiff