lily/dispatcher-scheme.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 2006--2014 Erik Sandberg  <mandolaerik@gmail.com>
   5
   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.
  10
  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.
  15
  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/>.
  18 */
  19
  20 #include "dispatcher.hh"
  21
  22 LY_DEFINE (ly_make_dispatcher, "ly:make-dispatcher",
  23            0, 0, 0, (),
  24            "Return a newly created dispatcher.")
  25 {
  26   return (new Dispatcher ())->unprotect ();
  27 }
  28
  29 LY_DEFINE (ly_connect_dispatchers, "ly:connect-dispatchers",
  30            2, 0, 0, (SCM to, SCM from),
  31            "Make the dispatcher @var{to} listen to events from @var{from}.")
  32 {
  33   Dispatcher *t = Dispatcher::unsmob (to);
  34   Dispatcher *f = Dispatcher::unsmob (from);
  35
  36   LY_ASSERT_SMOB (Dispatcher, to, 1);
  37   LY_ASSERT_SMOB (Dispatcher, from, 2);
  38
  39   t->register_as_listener (f);
  40
  41   return SCM_UNSPECIFIED;
  42 }
  43
  44 LY_DEFINE (ly_add_listener, "ly:add-listener",
  45            2, 0, 1, (SCM list, SCM disp, SCM cl),
  46            "Add the listener @var{list} to the dispatcher @var{disp}."
  47            "  Whenever @var{disp} hears an event of class @var{cl},"
  48            " it is forwarded to @var{list}.")
  49 {
  50   Listener *l = Listener::unsmob (list);
  51   Dispatcher *d = Dispatcher::unsmob (disp);
  52
  53   LY_ASSERT_SMOB (Listener, list, 1);
  54   LY_ASSERT_SMOB (Dispatcher, disp, 2);
  55
  56   for (int arg = SCM_ARG3; scm_is_pair (cl); cl = scm_cdr (cl), arg++)
  57     {
  58       SCM sym = scm_car (cl);
  59       SCM_ASSERT_TYPE (scm_is_symbol (sym), sym, arg, __FUNCTION__, "symbol");
  60       d->add_listener (*l, sym);
  61     }
  62
  63   return SCM_UNSPECIFIED;
  64 }
  65
  66 LY_DEFINE (ly_listened_event_types, "ly:listened-event-types",
  67            1, 0, 0, (SCM disp),
  68            "Return a list of all event types that @var{disp} listens"
  69            " to.")
  70 {
  71   LY_ASSERT_SMOB (Dispatcher, disp, 1);
  72
  73   SCM result = Dispatcher::unsmob (disp)->listened_types ();
  74
  75   scm_remember_upto_here_1 (disp);
  76
  77   return result;
  78 }
  79
  80 LY_DEFINE (ly_listened_event_class_p, "ly:listened-event-class?",
  81            2, 0, 0, (SCM disp, SCM cl),
  82            "Does @var{disp} listen to any event type in the list"
  83            " @var{cl}?")
  84 {
  85   LY_ASSERT_SMOB (Dispatcher, disp, 1);
  86   LY_ASSERT_TYPE (scm_is_pair, cl, 2);
  87
  88   bool result = Dispatcher::unsmob (disp)->is_listened_class (cl);
  89
  90   scm_remember_upto_here_1 (disp);
  91
  92   return scm_from_bool (result);
  93 }
  94
  95 LY_DEFINE (ly_broadcast, "ly:broadcast",
  96            2, 0, 0, (SCM disp, SCM ev),
  97            "Send the stream event @var{ev} to the dispatcher @var{disp}.")
  98 {
  99   Dispatcher *d = Dispatcher::unsmob (disp);
 100   Stream_event *e = unsmob_stream_event (ev);
 101
 102   LY_ASSERT_SMOB (Dispatcher, disp, 1);
 103
 104   LY_ASSERT_SMOB (Stream_event, ev, 2);
 105   d->broadcast (e);
 106   return SCM_UNSPECIFIED;
 107 }