0f02f943ea4281a79184af037c8a39381075c349
[ardour.git] / gtk2_ardour / luainstance.cc
1 /*
2  * Copyright (C) 2016 Robin Gareus <robin@gareus.org>
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
17  */
18
19 #include <cairomm/context.h>
20 #include <cairomm/surface.h>
21 #include <pango/pangocairo.h>
22
23 #include "gtkmm2ext/gui_thread.h"
24
25 #include "ardour/audioengine.h"
26 #include "ardour/diskstream.h"
27 #include "ardour/plugin_manager.h"
28 #include "ardour/route.h"
29 #include "ardour/session.h"
30
31 #include "LuaBridge/LuaBridge.h"
32
33 #include "ardour_http.h"
34 #include "ardour_ui.h"
35 #include "public_editor.h"
36 #include "region_selection.h"
37 #include "luainstance.h"
38 #include "luasignal.h"
39 #include "marker.h"
40 #include "processor_box.h"
41 #include "time_axis_view.h"
42 #include "selection.h"
43 #include "script_selector.h"
44 #include "timers.h"
45 #include "utils_videotl.h"
46
47 #include "pbd/i18n.h"
48
49 namespace LuaCairo {
50 /** wrap RefPtr< Cairo::ImageSurface >
51  *
52  * Image surfaces provide the ability to render to memory buffers either
53  * allocated by cairo or by the calling code. The supported image formats are
54  * those defined in Cairo::Format.
55  */
56 class ImageSurface {
57         public:
58                 /**
59                  * Creates an image surface of the specified format and dimensions. Initially
60                  * the surface contents are all 0. (Specifically, within each pixel, each
61                  * color or alpha channel belonging to format will be 0. The contents of bits
62                  * within a pixel, but not belonging to the given format are undefined).
63                  *
64                  * @param format        format of pixels in the surface to create
65                  * @param width         width of the surface, in pixels
66                  * @param height        height of the surface, in pixels
67                  */
68                 ImageSurface (Cairo::Format format, int width, int height)
69                         : _surface (Cairo::ImageSurface::create (format, width, height))
70                         , _ctx (Cairo::Context::create (_surface))
71                         , ctx (_ctx->cobj ()) {}
72
73                 ~ImageSurface () {}
74
75                 /**
76                  * Set this surface as source for another context.
77                  * This allows to draw this surface
78                  */
79                 void set_as_source (Cairo::Context* c, int x, int y) {
80                         _surface->flush ();
81                         c->set_source (_surface, x, y);
82                 }
83
84                 /**
85                  * Returns a context object to perform operations on the surface
86                  */
87                 Cairo::Context* context () {
88                         return (Cairo::Context *)&ctx;
89                 }
90
91                 /**
92                  * Returns the stride of the image surface in bytes (or 0 if surface is not
93                  * an image surface). The stride is the distance in bytes from the beginning
94                  * of one row of the image data to the beginning of the next row.
95                  */
96                 int get_stride () const {
97                         return _surface->get_stride ();
98                 }
99
100                 /** Gets the width of the ImageSurface in pixels */
101                 int get_width () const {
102                         return _surface->get_width ();
103                 }
104
105                 /** Gets the height of the ImageSurface in pixels */
106                 int get_height () const {
107                         return _surface->get_height ();
108                 }
109
110                 /**
111                  * Get a pointer to the data of the image surface, for direct
112                  * inspection or modification.
113                  *
114                  * Return value: a pointer to the image data of this surface or NULL
115                  * if @surface is not an image surface.
116                  *
117                  */
118                 unsigned char* get_data () {
119                         return _surface->get_data ();
120                 }
121
122                 /** Tells cairo to consider the data buffer dirty.
123                  *
124                  * In particular, if you've created an ImageSurface with a data buffer that
125                  * you've allocated yourself and you draw to that data buffer using means
126                  * other than cairo, you must call mark_dirty() before doing any additional
127                  * drawing to that surface with cairo.
128                  *
129                  * Note that if you do draw to the Surface outside of cairo, you must call
130                  * flush() before doing the drawing.
131                  */
132                 void mark_dirty () {
133                         _surface->mark_dirty ();
134                 }
135
136                 /** Marks a rectangular area of the given surface dirty.
137                  *
138                  * @param x      X coordinate of dirty rectangle
139                  * @param y     Y coordinate of dirty rectangle
140                  * @param width         width of dirty rectangle
141                  * @param height        height of dirty rectangle
142                  */
143                 void mark_dirty (int x, int y, int width, int height) {
144                         _surface->mark_dirty (x, y, width, height);
145                 }
146
147         private:
148                 Cairo::RefPtr<Cairo::ImageSurface> _surface;
149                 Cairo::RefPtr<Cairo::Context> _ctx;
150                 Cairo::Context ctx;
151 };
152
153 class PangoLayout {
154         public:
155                 /** Create a new PangoLayout Text Display
156                  * @param c CairoContext for the layout
157                  * @param font_name a font-description e.g. "Mono 8px"
158                  */
159                 PangoLayout (Cairo::Context* c, std::string font_name) {
160                         ::PangoLayout* pl = pango_cairo_create_layout (c->cobj ());
161                         _layout = Glib::wrap (pl);
162                         Pango::FontDescription fd (font_name);
163                         _layout->set_font_description (fd);
164                 }
165
166                 ~PangoLayout () {}
167
168                 /** Gets the text in the layout. The returned text should not
169                  * be freed or modified.
170                  *
171                  * @return The text in the @a layout.
172                  */
173                 std::string get_text () const {
174                         return _layout->get_text ();
175                 }
176                 /** Set the text of the layout.
177                  * @param text The text for the layout.
178                  */
179                 void set_text (const std::string& text) {
180                         _layout->set_text (text);
181                 }
182
183                 /** Sets the layout text and attribute list from marked-up text (see markup format).
184                  * Replaces the current text and attribute list.
185                  * @param markup Some marked-up text.
186                  */
187                 void set_markup (const std::string& markup) {
188                         _layout->set_markup (markup);
189                 }
190
191                 /** Sets the width to which the lines of the Pango::Layout should wrap or
192                  * ellipsized.  The default value is -1: no width set.
193                  *
194                  * @param width The desired width in Pango units, or -1 to indicate that no
195                  * wrapping or ellipsization should be performed.
196                  */
197                 void set_width (int width) {
198                         _layout->set_width (width * PANGO_SCALE);
199                 }
200
201                 /** Gets the width to which the lines of the Pango::Layout should wrap.
202                  *
203                  * @return The width in Pango units, or -1 if no width set.
204                  */
205                 int get_width () const {
206                         return _layout->get_width () / PANGO_SCALE;
207                 }
208
209                 /** Sets the type of ellipsization being performed for @a layout.
210                  * Depending on the ellipsization mode @a ellipsize text is
211                  * removed from the start, middle, or end of text so they
212                  * fit within the width and height of layout set with
213                  * set_width() and set_height().
214                  *
215                  * If the layout contains characters such as newlines that
216                  * force it to be layed out in multiple paragraphs, then whether
217                  * each paragraph is ellipsized separately or the entire layout
218                  * is ellipsized as a whole depends on the set height of the layout.
219                  * See set_height() for details.
220                  *
221                  * @param ellipsize The new ellipsization mode for @a layout.
222                  */
223                 void set_ellipsize (Pango::EllipsizeMode ellipsize) {
224                         _layout->set_ellipsize (ellipsize);
225                 }
226
227                 /** Gets the type of ellipsization being performed for @a layout.
228                  * See set_ellipsize()
229                  *
230                  * @return The current ellipsization mode for @a layout.
231                  *
232                  * Use is_ellipsized() to query whether any paragraphs
233                  * were actually ellipsized.
234                  */
235                 Pango::EllipsizeMode get_ellipsize () const {
236                         return _layout->get_ellipsize ();
237                 }
238
239                 /** Queries whether the layout had to ellipsize any paragraphs.
240                  *
241                  * This returns <tt>true</tt> if the ellipsization mode for @a layout
242                  * is not Pango::ELLIPSIZE_NONE, a positive width is set on @a layout,
243                  * and there are paragraphs exceeding that width that have to be
244                  * ellipsized.
245                  *
246                  * @return <tt>true</tt> if any paragraphs had to be ellipsized, <tt>false</tt>
247                  * otherwise.
248                  */
249                 bool is_ellipsized () const {
250                         return _layout->is_ellipsized ();
251                 }
252
253                 /** Sets the wrap mode; the wrap mode only has effect if a width
254                  * is set on the layout with set_width().
255                  * To turn off wrapping, set the width to -1.
256                  *
257                  * @param wrap The wrap mode.
258                  */
259                 void set_wrap (Pango::WrapMode wrap) {
260                         _layout->set_width (wrap);
261                 }
262
263                 /** Gets the wrap mode for the layout.
264                  *
265                  * Use is_wrapped() to query whether any paragraphs
266                  * were actually wrapped.
267                  *
268                  * @return Active wrap mode.
269                  */
270                 Pango::WrapMode get_wrap () const {
271                         return _layout->get_wrap ();
272                 }
273
274                 /** Queries whether the layout had to wrap any paragraphs.
275                  *
276                  * This returns <tt>true</tt> if a positive width is set on @a layout,
277                  * ellipsization mode of @a layout is set to Pango::ELLIPSIZE_NONE,
278                  * and there are paragraphs exceeding the layout width that have
279                  * to be wrapped.
280                  *
281                  * @return <tt>true</tt> if any paragraphs had to be wrapped, <tt>false</tt>
282                  * otherwise.
283                  */
284                 bool is_wrapped () const {
285                         return _layout->is_wrapped ();
286                 }
287
288                 /** Determines the logical width and height of a Pango::Layout
289                  * in device units.
290                  */
291                 int get_pixel_size (lua_State *L) {
292                         int width, height;
293                         _layout->get_pixel_size (width, height);
294                         luabridge::Stack<int>::push (L, width);
295                         luabridge::Stack<int>::push (L, height);
296                         return 2;
297                 }
298
299
300                 /** Draws a Layout in the specified Cairo @a context. The top-left
301                  *  corner of the Layout will be drawn at the current point of the
302                  *  cairo context.
303                  *
304                  * @param context A Cairo context.
305                  */
306                 void show_in_cairo_context (Cairo::Context* c) {
307                         pango_cairo_update_layout (c->cobj (), _layout->gobj());
308                         pango_cairo_show_layout (c->cobj (), _layout->gobj());
309                 }
310
311         private:
312                 Glib::RefPtr<Pango::Layout> _layout;
313 };
314
315 }; // namespace
316
317 ////////////////////////////////////////////////////////////////////////////////
318
319 namespace LuaSignal {
320
321 #define STATIC(name,c,p) else if (!strcmp(type, #name)) {return name;}
322 #define SESSION(name,c,p) else if (!strcmp(type, #name)) {return name;}
323 #define ENGINE(name,c,p) else if (!strcmp(type, #name)) {return name;}
324
325 LuaSignal
326 str2luasignal (const std::string &str) {
327         const char* type = str.c_str();
328         if (0) { }
329 #       include "luasignal_syms.h"
330         else {
331                 PBD::fatal << string_compose (_("programming error: %1: %2"), "Impossible LuaSignal type", str) << endmsg;
332                 abort(); /*NOTREACHED*/
333         }
334 }
335 #undef STATIC
336 #undef SESSION
337 #undef ENGINE
338
339 #define STATIC(name,c,p) N_(#name),
340 #define SESSION(name,c,p) N_(#name),
341 #define ENGINE(name,c,p) N_(#name),
342 const char *luasignalstr[] = {
343 #       include "luasignal_syms.h"
344         0
345 };
346
347 #undef STATIC
348 #undef SESSION
349 #undef ENGINE
350 }; // namespace
351
352
353 /** special cases for Ardour's Mixer UI */
354 namespace LuaMixer {
355
356         ProcessorBox::ProcSelection
357         processor_selection (lua_State* L) {
358                 return ProcessorBox::current_processor_selection ();
359         }
360
361 };
362
363 ////////////////////////////////////////////////////////////////////////////////
364
365 #define xstr(s) stringify(s)
366 #define stringify(s) #s
367
368 using namespace ARDOUR;
369
370 PBD::Signal0<void> LuaInstance::LuaTimerDS;
371
372 void
373 LuaInstance::register_hooks (lua_State* L)
374 {
375
376 #define ENGINE(name,c,p) .addConst (stringify(name), (LuaSignal::LuaSignal)LuaSignal::name)
377 #define STATIC(name,c,p) .addConst (stringify(name), (LuaSignal::LuaSignal)LuaSignal::name)
378 #define SESSION(name,c,p) .addConst (stringify(name), (LuaSignal::LuaSignal)LuaSignal::name)
379         luabridge::getGlobalNamespace (L)
380                 .beginNamespace ("LuaSignal")
381 #               include "luasignal_syms.h"
382                 .endNamespace ();
383 #undef ENGINE
384 #undef SESSION
385 #undef STATIC
386
387         luabridge::getGlobalNamespace (L)
388                 .beginNamespace ("LuaSignal")
389                 .beginStdBitSet <LuaSignal::LAST_SIGNAL> ("Set")
390                 .endClass()
391                 .endNamespace ();
392 }
393
394 void
395 LuaInstance::bind_cairo (lua_State* L)
396 {
397         /* std::vector<double> for set_dash()
398          * for Windows (DLL, .exe) this needs to be bound in the same memory context as "Cairo".
399          *
400          * The std::vector<> argument in set_dash() has a fixed address in ardour.exe, while
401          * the address of the one in libardour.dll is mapped when loading the .dll
402          *
403          * see LuaBindings::set_session() for a detailed explanation
404          */
405         luabridge::getGlobalNamespace (L)
406                 .beginNamespace ("C")
407                 .beginStdVector <double> ("DoubleVector")
408                 .endClass ()
409                 .endNamespace ();
410
411         luabridge::getGlobalNamespace (L)
412                 .beginNamespace ("Cairo")
413                 .beginClass <Cairo::Context> ("Context")
414                 .addFunction ("save", &Cairo::Context::save)
415                 .addFunction ("restore", &Cairo::Context::restore)
416                 .addFunction ("set_operator", &Cairo::Context::set_operator)
417                 //.addFunction ("set_source", &Cairo::Context::set_operator) // needs RefPtr
418                 .addFunction ("set_source_rgb", &Cairo::Context::set_source_rgb)
419                 .addFunction ("set_source_rgba", &Cairo::Context::set_source_rgba)
420                 .addFunction ("set_line_width", &Cairo::Context::set_line_width)
421                 .addFunction ("set_line_cap", &Cairo::Context::set_line_cap)
422                 .addFunction ("set_line_join", &Cairo::Context::set_line_join)
423                 .addFunction ("set_dash", (void (Cairo::Context::*)(const std::vector<double>&, double))&Cairo::Context::set_dash)
424                 .addFunction ("unset_dash", &Cairo::Context::unset_dash)
425                 .addFunction ("translate", &Cairo::Context::translate)
426                 .addFunction ("scale", &Cairo::Context::scale)
427                 .addFunction ("rotate", &Cairo::Context::rotate)
428                 .addFunction ("begin_new_path", &Cairo::Context::begin_new_path)
429                 .addFunction ("begin_new_sub_path", &Cairo::Context::begin_new_sub_path)
430                 .addFunction ("move_to", &Cairo::Context::move_to)
431                 .addFunction ("line_to", &Cairo::Context::line_to)
432                 .addFunction ("curve_to", &Cairo::Context::curve_to)
433                 .addFunction ("arc", &Cairo::Context::arc)
434                 .addFunction ("arc_negative", &Cairo::Context::arc_negative)
435                 .addFunction ("rel_move_to", &Cairo::Context::rel_move_to)
436                 .addFunction ("rel_line_to", &Cairo::Context::rel_line_to)
437                 .addFunction ("rel_curve_to", &Cairo::Context::rel_curve_to)
438                 .addFunction ("rectangle", (void (Cairo::Context::*)(double, double, double, double))&Cairo::Context::rectangle)
439                 .addFunction ("close_path", &Cairo::Context::close_path)
440                 .addFunction ("paint", &Cairo::Context::paint)
441                 .addFunction ("paint_with_alpha", &Cairo::Context::paint_with_alpha)
442                 .addFunction ("stroke", &Cairo::Context::stroke)
443                 .addFunction ("stroke_preserve", &Cairo::Context::stroke_preserve)
444                 .addFunction ("fill", &Cairo::Context::fill)
445                 .addFunction ("fill_preserve", &Cairo::Context::fill_preserve)
446                 .addFunction ("reset_clip", &Cairo::Context::reset_clip)
447                 .addFunction ("clip", &Cairo::Context::clip)
448                 .addFunction ("clip_preserve", &Cairo::Context::clip_preserve)
449                 .addFunction ("set_font_size", &Cairo::Context::set_font_size)
450                 .addFunction ("show_text", &Cairo::Context::show_text)
451                 .endClass ()
452                 /* enums */
453                 // LineCap, LineJoin, Operator
454                 .beginNamespace ("LineCap")
455                 .addConst ("Butt", CAIRO_LINE_CAP_BUTT)
456                 .addConst ("Round", CAIRO_LINE_CAP_ROUND)
457                 .addConst ("Square", CAIRO_LINE_CAP_SQUARE)
458                 .endNamespace ()
459
460                 .beginNamespace ("LineJoin")
461                 .addConst ("Miter", CAIRO_LINE_JOIN_MITER)
462                 .addConst ("Round", CAIRO_LINE_JOIN_ROUND)
463                 .addConst ("Bevel", CAIRO_LINE_JOIN_BEVEL)
464                 .endNamespace ()
465
466                 .beginNamespace ("Operator")
467                 .addConst ("Clear", CAIRO_OPERATOR_CLEAR)
468                 .addConst ("Source", CAIRO_OPERATOR_SOURCE)
469                 .addConst ("Over", CAIRO_OPERATOR_OVER)
470                 .addConst ("Add", CAIRO_OPERATOR_ADD)
471                 .endNamespace ()
472
473                 .beginNamespace ("Format")
474                 .addConst ("ARGB32", CAIRO_FORMAT_ARGB32)
475                 .addConst ("RGB24", CAIRO_FORMAT_RGB24)
476                 .endNamespace ()
477
478                 .beginClass <LuaCairo::ImageSurface> ("ImageSurface")
479                 .addConstructor <void (*) (Cairo::Format, int, int)> ()
480                 .addFunction ("set_as_source", &LuaCairo::ImageSurface::set_as_source)
481                 .addFunction ("context", &LuaCairo::ImageSurface::context)
482                 .addFunction ("get_stride", &LuaCairo::ImageSurface::get_stride)
483                 .addFunction ("get_width", &LuaCairo::ImageSurface::get_width)
484                 .addFunction ("get_height", &LuaCairo::ImageSurface::get_height)
485                 //.addFunction ("get_data", &LuaCairo::ImageSurface::get_data) // uint8_t* array is n/a
486                 .endClass ()
487
488                 .beginClass <LuaCairo::PangoLayout> ("PangoLayout")
489                 .addConstructor <void (*) (Cairo::Context*, std::string)> ()
490                 .addCFunction ("get_pixel_size", &LuaCairo::PangoLayout::get_pixel_size)
491                 .addFunction ("get_text", &LuaCairo::PangoLayout::get_text)
492                 .addFunction ("set_text", &LuaCairo::PangoLayout::set_text)
493                 .addFunction ("show_in_cairo_context", &LuaCairo::PangoLayout::show_in_cairo_context)
494                 .addFunction ("set_markup", &LuaCairo::PangoLayout::set_markup)
495                 .addFunction ("set_width", &LuaCairo::PangoLayout::set_width)
496                 .addFunction ("set_ellipsize", &LuaCairo::PangoLayout::set_ellipsize)
497                 .addFunction ("get_ellipsize", &LuaCairo::PangoLayout::get_ellipsize)
498                 .addFunction ("is_ellipsized", &LuaCairo::PangoLayout::is_ellipsized)
499                 .addFunction ("set_wrap", &LuaCairo::PangoLayout::set_wrap)
500                 .addFunction ("get_wrap", &LuaCairo::PangoLayout::get_wrap)
501                 .addFunction ("is_wrapped", &LuaCairo::PangoLayout::is_wrapped)
502                 .endClass ()
503
504                 /* enums */
505                 .beginNamespace ("EllipsizeMode")
506                 .addConst ("None", Pango::ELLIPSIZE_NONE)
507                 .addConst ("Start", Pango::ELLIPSIZE_START)
508                 .addConst ("Middle", Pango::ELLIPSIZE_MIDDLE)
509                 .addConst ("End", Pango::ELLIPSIZE_END)
510                 .endNamespace ()
511
512                 .beginNamespace ("WrapMode")
513                 .addConst ("Word", Pango::WRAP_WORD)
514                 .addConst ("Char", Pango::WRAP_CHAR)
515                 .addConst ("WordChar", Pango::WRAP_WORD_CHAR)
516                 .endNamespace ()
517
518                 .endNamespace ();
519
520 /* Lua/cairo bindings operate on Cairo::Context, there is no Cairo::RefPtr wrapper [yet].
521   one can work around this as follows:
522
523   LuaState lua;
524   LuaInstance::register_classes (lua.getState());
525   lua.do_command (
526       "function render (ctx)"
527       "  ctx:rectangle (0, 0, 100, 100)"
528       "  ctx:set_source_rgba (0.1, 1.0, 0.1, 1.0)"
529       "  ctx:fill ()"
530       " end"
531       );
532   {
533                 Cairo::RefPtr<Cairo::Context> context = get_window ()->create_cairo_context ();
534     Cairo::Context ctx (context->cobj ());
535
536     luabridge::LuaRef lua_render = luabridge::getGlobal (lua.getState(), "render");
537     lua_render ((Cairo::Context *)&ctx);
538   }
539 */
540
541 }
542
543 void
544 LuaInstance::register_classes (lua_State* L)
545 {
546         LuaBindings::stddef (L);
547         LuaBindings::common (L);
548         LuaBindings::session (L);
549         LuaBindings::osc (L);
550
551         bind_cairo (L);
552         register_hooks (L);
553
554         luabridge::getGlobalNamespace (L)
555                 .beginNamespace ("ArdourUI")
556
557                 .addFunction ("http_get", (std::string (*)(const std::string&))&ArdourCurl::http_get)
558
559                 .addFunction ("processor_selection", &LuaMixer::processor_selection)
560
561                 .beginStdList <ArdourMarker*> ("ArdourMarkerList")
562                 .endClass ()
563
564                 .beginClass <ArdourMarker> ("ArdourMarker")
565                 .addFunction ("name", &ArdourMarker::name)
566                 .addFunction ("position", &ArdourMarker::position)
567                 .addFunction ("_type", &ArdourMarker::type)
568                 .endClass ()
569
570 #if 0
571                 .beginClass <AxisView> ("AxisView")
572                 .endClass ()
573                 .deriveClass <TimeAxisView, AxisView> ("TimeAxisView")
574                 .endClass ()
575                 .deriveClass <RouteTimeAxisView, TimeAxisView> ("RouteTimeAxisView")
576                 .endClass ()
577 #endif
578
579                 .beginClass <RegionSelection> ("RegionSelection")
580                 .addFunction ("clear_all", &RegionSelection::clear_all)
581                 .addFunction ("start", &RegionSelection::start)
582                 .addFunction ("end_frame", &RegionSelection::end_frame)
583                 .addFunction ("n_midi_regions", &RegionSelection::n_midi_regions)
584                 .addFunction ("regionlist", &RegionSelection::regionlist) // XXX check windows binding (libardour)
585                 .endClass ()
586
587                 .deriveClass <TimeSelection, std::list<ARDOUR::AudioRange> > ("TimeSelection")
588                 .addFunction ("start", &TimeSelection::start)
589                 .addFunction ("end_frame", &TimeSelection::end_frame)
590                 .addFunction ("length", &TimeSelection::length)
591                 .endClass ()
592
593                 .deriveClass <MarkerSelection, std::list<ArdourMarker*> > ("MarkerSelection")
594                 .endClass ()
595
596                 .beginClass <TrackViewList> ("TrackViewList")
597                 .addFunction ("routelist", &TrackViewList::routelist) // XXX check windows binding (libardour)
598                 .endClass ()
599
600                 .deriveClass <TrackSelection, TrackViewList> ("TrackSelection")
601                 .endClass ()
602
603                 .beginClass <Selection> ("Selection")
604                 .addFunction ("clear", &Selection::clear)
605                 .addFunction ("clear_all", &Selection::clear_all)
606                 .addFunction ("empty", &Selection::empty)
607                 .addData ("tracks", &Selection::tracks)
608                 .addData ("regions", &Selection::regions)
609                 .addData ("time", &Selection::time)
610                 .addData ("markers", &Selection::markers)
611 #if 0
612                 .addData ("lines", &Selection::lines)
613                 .addData ("playlists", &Selection::playlists)
614                 .addData ("points", &Selection::points)
615                 .addData ("midi_regions", &Selection::midi_regions)
616                 .addData ("midi_notes", &Selection::midi_notes) // cut buffer only
617 #endif
618                 .endClass ()
619
620                 .beginClass <PublicEditor> ("Editor")
621                 .addFunction ("snap_type", &PublicEditor::snap_type)
622                 .addFunction ("snap_mode", &PublicEditor::snap_mode)
623                 .addFunction ("set_snap_mode", &PublicEditor::set_snap_mode)
624                 .addFunction ("set_snap_threshold", &PublicEditor::set_snap_threshold)
625
626                 .addFunction ("undo", &PublicEditor::undo)
627                 .addFunction ("redo", &PublicEditor::redo)
628
629                 .addFunction ("set_mouse_mode", &PublicEditor::set_mouse_mode)
630                 .addFunction ("current_mouse_mode", &PublicEditor::current_mouse_mode)
631
632                 .addFunction ("consider_auditioning", &PublicEditor::consider_auditioning)
633
634                 .addFunction ("new_region_from_selection", &PublicEditor::new_region_from_selection)
635                 .addFunction ("separate_region_from_selection", &PublicEditor::separate_region_from_selection)
636                 .addFunction ("pixel_to_sample", &PublicEditor::pixel_to_sample)
637                 .addFunction ("sample_to_pixel", &PublicEditor::sample_to_pixel)
638
639                 .addFunction ("get_selection", &PublicEditor::get_selection)
640                 .addFunction ("get_cut_buffer", &PublicEditor::get_cut_buffer)
641                 .addRefFunction ("get_selection_extents", &PublicEditor::get_selection_extents)
642
643                 .addFunction ("play_selection", &PublicEditor::play_selection)
644                 .addFunction ("play_with_preroll", &PublicEditor::play_with_preroll)
645                 .addFunction ("maybe_locate_with_edit_preroll", &PublicEditor::maybe_locate_with_edit_preroll)
646                 .addFunction ("goto_nth_marker", &PublicEditor::goto_nth_marker)
647
648                 .addFunction ("add_location_from_playhead_cursor", &PublicEditor::add_location_from_playhead_cursor)
649                 .addFunction ("remove_location_at_playhead_cursor", &PublicEditor::remove_location_at_playhead_cursor)
650
651                 .addFunction ("set_show_measures", &PublicEditor::set_show_measures)
652                 .addFunction ("show_measures", &PublicEditor::show_measures)
653                 .addFunction ("remove_tracks", &PublicEditor::remove_tracks)
654
655                 .addFunction ("set_loop_range", &PublicEditor::set_loop_range)
656                 .addFunction ("set_punch_range", &PublicEditor::set_punch_range)
657
658                 .addFunction ("effective_mouse_mode", &PublicEditor::effective_mouse_mode)
659
660                 .addRefFunction ("do_import", &PublicEditor::do_import)
661                 .addRefFunction ("do_embed", &PublicEditor::do_embed)
662
663                 .addFunction ("export_audio", &PublicEditor::export_audio)
664                 .addFunction ("stem_export", &PublicEditor::stem_export)
665                 .addFunction ("export_selection", &PublicEditor::export_selection)
666                 .addFunction ("export_range", &PublicEditor::export_range)
667
668                 .addFunction ("set_zoom_focus", &PublicEditor::set_zoom_focus)
669                 .addFunction ("get_zoom_focus", &PublicEditor::get_zoom_focus)
670                 .addFunction ("get_current_zoom", &PublicEditor::get_current_zoom)
671                 .addFunction ("reset_zoom", &PublicEditor::reset_zoom)
672
673 #if 0 // These need TimeAxisView* which isn't exposed, yet
674                 .addFunction ("playlist_selector", &PublicEditor::playlist_selector)
675                 .addFunction ("clear_playlist", &PublicEditor::clear_playlist)
676                 .addFunction ("new_playlists", &PublicEditor::new_playlists)
677                 .addFunction ("copy_playlists", &PublicEditor::copy_playlists)
678                 .addFunction ("clear_playlists", &PublicEditor::clear_playlists)
679 #endif
680
681                 .addFunction ("select_all_tracks", &PublicEditor::select_all_tracks)
682                 .addFunction ("deselect_all", &PublicEditor::deselect_all)
683 #if 0
684                 .addFunction ("set_selected_track", &PublicEditor::set_selected_track)
685                 .addFunction ("set_selected_mixer_strip", &PublicEditor::set_selected_mixer_strip)
686                 .addFunction ("hide_track_in_display", &PublicEditor::hide_track_in_display)
687 #endif
688                 .addFunction ("set_stationary_playhead", &PublicEditor::set_stationary_playhead)
689                 .addFunction ("stationary_playhead", &PublicEditor::stationary_playhead)
690                 .addFunction ("set_follow_playhead", &PublicEditor::set_follow_playhead)
691                 .addFunction ("follow_playhead", &PublicEditor::follow_playhead)
692
693                 .addFunction ("dragging_playhead", &PublicEditor::dragging_playhead)
694                 .addFunction ("leftmost_sample", &PublicEditor::leftmost_sample)
695                 .addFunction ("current_page_samples", &PublicEditor::current_page_samples)
696                 .addFunction ("visible_canvas_height", &PublicEditor::visible_canvas_height)
697                 .addFunction ("temporal_zoom_step", &PublicEditor::temporal_zoom_step)
698                 //.addFunction ("ensure_time_axis_view_is_visible", &PublicEditor::ensure_time_axis_view_is_visible)
699                 .addFunction ("override_visible_track_count", &PublicEditor::override_visible_track_count)
700
701                 .addFunction ("scroll_tracks_down_line", &PublicEditor::scroll_tracks_down_line)
702                 .addFunction ("scroll_tracks_up_line", &PublicEditor::scroll_tracks_up_line)
703                 .addFunction ("scroll_down_one_track", &PublicEditor::scroll_down_one_track)
704                 .addFunction ("scroll_up_one_track", &PublicEditor::scroll_up_one_track)
705
706                 .addFunction ("reset_x_origin", &PublicEditor::reset_x_origin)
707                 .addFunction ("get_y_origin", &PublicEditor::get_y_origin)
708                 .addFunction ("reset_y_origin", &PublicEditor::reset_y_origin)
709
710                 .addFunction ("remove_last_capture", &PublicEditor::remove_last_capture)
711
712                 .addFunction ("maximise_editing_space", &PublicEditor::maximise_editing_space)
713                 .addFunction ("restore_editing_space", &PublicEditor::restore_editing_space)
714                 .addFunction ("toggle_meter_updating", &PublicEditor::toggle_meter_updating)
715
716                 //.addFunction ("get_preferred_edit_position", &PublicEditor::get_preferred_edit_position)
717                 //.addFunction ("split_regions_at", &PublicEditor::split_regions_at)
718
719                 .addRefFunction ("get_nudge_distance", &PublicEditor::get_nudge_distance)
720                 .addFunction ("get_paste_offset", &PublicEditor::get_paste_offset)
721                 .addFunction ("get_grid_beat_divisions", &PublicEditor::get_grid_beat_divisions)
722                 .addRefFunction ("get_grid_type_as_beats", &PublicEditor::get_grid_type_as_beats)
723
724                 .addFunction ("toggle_ruler_video", &PublicEditor::toggle_ruler_video)
725                 .addFunction ("toggle_xjadeo_proc", &PublicEditor::toggle_xjadeo_proc)
726                 .addFunction ("get_videotl_bar_height", &PublicEditor::get_videotl_bar_height)
727                 .addFunction ("set_video_timeline_height", &PublicEditor::set_video_timeline_height)
728
729 #if 0
730                 .addFunction ("get_route_view_by_route_id", &PublicEditor::get_route_view_by_route_id)
731                 .addFunction ("get_equivalent_regions", &PublicEditor::get_equivalent_regions)
732
733                 .addFunction ("axis_view_from_route", &PublicEditor::axis_view_from_route)
734                 .addFunction ("axis_views_from_routes", &PublicEditor::axis_views_from_routes)
735                 .addFunction ("get_track_views", &PublicEditor::get_track_views)
736                 .addFunction ("drags", &PublicEditor::drags)
737 #endif
738
739                 .addFunction ("center_screen", &PublicEditor::center_screen)
740
741                 .addFunction ("get_smart_mode", &PublicEditor::get_smart_mode)
742                 .addRefFunction ("get_pointer_position", &PublicEditor::get_pointer_position)
743
744                 .addRefFunction ("find_location_from_marker", &PublicEditor::find_location_from_marker)
745                 .addFunction ("find_marker_from_location_id", &PublicEditor::find_marker_from_location_id)
746                 .addFunction ("mouse_add_new_marker", &PublicEditor::mouse_add_new_marker)
747 #if 0
748                 .addFunction ("get_regions_at", &PublicEditor::get_regions_at)
749                 .addFunction ("get_regions_after", &PublicEditor::get_regions_after)
750                 .addFunction ("get_regions_from_selection_and_mouse", &PublicEditor::get_regions_from_selection_and_mouse)
751                 .addFunction ("get_regionviews_by_id", &PublicEditor::get_regionviews_by_id)
752                 .addFunction ("get_per_region_note_selection", &PublicEditor::get_per_region_note_selection)
753 #endif
754
755 #if 0
756                 .addFunction ("mouse_add_new_tempo_event", &PublicEditor::mouse_add_new_tempo_event)
757                 .addFunction ("mouse_add_new_meter_event", &PublicEditor::mouse_add_new_meter_event)
758                 .addFunction ("edit_tempo_section", &PublicEditor::edit_tempo_section)
759                 .addFunction ("edit_meter_section", &PublicEditor::edit_meter_section)
760 #endif
761
762                 .addFunction ("access_action", &PublicEditor::access_action)
763                 .endClass ()
764
765                 /* ArdourUI enums */
766                 .beginNamespace ("MarkerType")
767                 .addConst ("Mark", ArdourMarker::Type(ArdourMarker::Mark))
768                 .addConst ("Tempo", ArdourMarker::Type(ArdourMarker::Tempo))
769                 .addConst ("Meter", ArdourMarker::Type(ArdourMarker::Meter))
770                 .addConst ("SessionStart", ArdourMarker::Type(ArdourMarker::SessionStart))
771                 .addConst ("SessionEnd", ArdourMarker::Type(ArdourMarker::SessionEnd))
772                 .addConst ("RangeStart", ArdourMarker::Type(ArdourMarker::RangeStart))
773                 .addConst ("RangeEnd", ArdourMarker::Type(ArdourMarker::RangeEnd))
774                 .addConst ("LoopStart", ArdourMarker::Type(ArdourMarker::LoopStart))
775                 .addConst ("LoopEnd", ArdourMarker::Type(ArdourMarker::LoopEnd))
776                 .addConst ("PunchIn", ArdourMarker::Type(ArdourMarker::PunchIn))
777                 .addConst ("PunchOut", ArdourMarker::Type(ArdourMarker::PunchOut))
778                 .endNamespace ()
779
780                 .endNamespace (); // end ArdourUI
781
782         // Editing Symbols
783
784 #undef ZOOMFOCUS
785 #undef SNAPTYPE
786 #undef SNAPMODE
787 #undef MOUSEMODE
788 #undef DISPLAYCONTROL
789 #undef IMPORTMODE
790 #undef IMPORTPOSITION
791 #undef IMPORTDISPOSITION
792
793 #define ZOOMFOCUS(NAME) .addConst (stringify(NAME), (Editing::ZoomFocus)Editing::NAME)
794 #define SNAPTYPE(NAME) .addConst (stringify(NAME), (Editing::SnapType)Editing::NAME)
795 #define SNAPMODE(NAME) .addConst (stringify(NAME), (Editing::SnapMode)Editing::NAME)
796 #define MOUSEMODE(NAME) .addConst (stringify(NAME), (Editing::MouseMode)Editing::NAME)
797 #define DISPLAYCONTROL(NAME) .addConst (stringify(NAME), (Editing::DisplayControl)Editing::NAME)
798 #define IMPORTMODE(NAME) .addConst (stringify(NAME), (Editing::ImportMode)Editing::NAME)
799 #define IMPORTPOSITION(NAME) .addConst (stringify(NAME), (Editing::ImportPosition)Editing::NAME)
800 #define IMPORTDISPOSITION(NAME) .addConst (stringify(NAME), (Editing::ImportDisposition)Editing::NAME)
801         luabridge::getGlobalNamespace (L)
802                 .beginNamespace ("Editing")
803 #               include "editing_syms.h"
804                 .endNamespace ();
805 }
806
807 #undef xstr
808 #undef stringify
809
810 ////////////////////////////////////////////////////////////////////////////////
811
812 using namespace ARDOUR;
813 using namespace ARDOUR_UI_UTILS;
814 using namespace PBD;
815 using namespace std;
816
817 #ifndef NDEBUG
818 static void _lua_print (std::string s) {
819         std::cout << "LuaInstance: " << s << "\n";
820 }
821 #endif
822
823 LuaInstance* LuaInstance::_instance = 0;
824
825 LuaInstance*
826 LuaInstance::instance ()
827 {
828         if (!_instance) {
829                 _instance  = new LuaInstance;
830         }
831
832         return _instance;
833 }
834
835 LuaInstance::LuaInstance ()
836 {
837 #ifndef NDEBUG
838         lua.Print.connect (&_lua_print);
839 #endif
840         init ();
841
842         LuaScriptParamList args;
843 }
844
845 LuaInstance::~LuaInstance ()
846 {
847         delete _lua_call_action;
848         delete _lua_add_action;
849         delete _lua_del_action;
850         delete _lua_get_action;
851
852         delete _lua_load;
853         delete _lua_save;
854         delete _lua_clear;
855         _callbacks.clear();
856 }
857
858 void
859 LuaInstance::init ()
860 {
861         lua.do_command (
862                         "function ScriptManager ()"
863                         "  local self = { scripts = {}, instances = {} }"
864                         ""
865                         "  local remove = function (id)"
866                         "   self.scripts[id] = nil"
867                         "   self.instances[id] = nil"
868                         "  end"
869                         ""
870                         "  local addinternal = function (i, n, s, f, a)"
871                         "   assert(type(i) == 'number', 'id must be numeric')"
872                         "   assert(type(n) == 'string', 'Name must be string')"
873                         "   assert(type(s) == 'string', 'Script must be string')"
874                         "   assert(type(f) == 'function', 'Factory is a not a function')"
875                         "   assert(type(a) == 'table' or type(a) == 'nil', 'Given argument is invalid')"
876                         "   self.scripts[i] = { ['n'] = n, ['s'] = s, ['f'] = f, ['a'] = a }"
877                         "   local env = _ENV;  env.f = nil env.debug = nil os.exit = nil require = nil dofile = nil loadfile = nil package = nil"
878                         "   self.instances[i] = load (string.dump(f, true), nil, nil, env)(a)"
879                         "  end"
880                         ""
881                         "  local call = function (id)"
882                         "   if type(self.instances[id]) == 'function' then"
883                         "     local status, err = pcall (self.instances[id])"
884                         "     if not status then"
885                         "       print ('action \"'.. id .. '\": ', err)" // error out
886                         "       remove (id)"
887                         "     end"
888                         "   end"
889                         "   collectgarbage()"
890                         "  end"
891                         ""
892                         "  local add = function (i, n, s, b, a)"
893                         "   assert(type(b) == 'string', 'ByteCode must be string')"
894                         "   load (b)()" // assigns f
895                         "   assert(type(f) == 'string', 'Assigned ByteCode must be string')"
896                         "   addinternal (i, n, s, load(f), a)"
897                         "  end"
898                         ""
899                         "  local get = function (id)"
900                         "   if type(self.scripts[id]) == 'table' then"
901                         "    return { ['name'] = self.scripts[id]['n'],"
902                         "             ['script'] = self.scripts[id]['s'],"
903                         "             ['args'] = self.scripts[id]['a'] }"
904                         "   end"
905                         "   return nil"
906                         "  end"
907                         ""
908                         "  local function basic_serialize (o)"
909                         "    if type(o) == \"number\" then"
910                         "     return tostring(o)"
911                         "    else"
912                         "     return string.format(\"%q\", o)"
913                         "    end"
914                         "  end"
915                         ""
916                         "  local function serialize (name, value)"
917                         "   local rv = name .. ' = '"
918                         "   collectgarbage()"
919                         "   if type(value) == \"number\" or type(value) == \"string\" or type(value) == \"nil\" then"
920                         "    return rv .. basic_serialize(value) .. ' '"
921                         "   elseif type(value) == \"table\" then"
922                         "    rv = rv .. '{} '"
923                         "    for k,v in pairs(value) do"
924                         "     local fieldname = string.format(\"%s[%s]\", name, basic_serialize(k))"
925                         "     rv = rv .. serialize(fieldname, v) .. ' '"
926                         "     collectgarbage()" // string concatenation allocates a new string
927                         "    end"
928                         "    return rv;"
929                         "   elseif type(value) == \"function\" then"
930                         "     return rv .. string.format(\"%q\", string.dump(value, true))"
931                         "   else"
932                         "    error('cannot save a ' .. type(value))"
933                         "   end"
934                         "  end"
935                         ""
936                         ""
937                         "  local save = function ()"
938                         "   return (serialize('scripts', self.scripts))"
939                         "  end"
940                         ""
941                         "  local clear = function ()"
942                         "   self.scripts = {}"
943                         "   self.instances = {}"
944                         "   collectgarbage()"
945                         "  end"
946                         ""
947                         "  local restore = function (state)"
948                         "   clear()"
949                         "   load (state)()"
950                         "   for i, s in pairs (scripts) do"
951                         "    addinternal (i, s['n'], s['s'], load(s['f']), s['a'])"
952                         "   end"
953                         "   collectgarbage()"
954                         "  end"
955                         ""
956                         " return { call = call, add = add, remove = remove, get = get,"
957                         "          restore = restore, save = save, clear = clear}"
958                         " end"
959                         " "
960                         " manager = ScriptManager ()"
961                         " ScriptManager = nil"
962                         );
963
964         lua_State* L = lua.getState();
965
966         try {
967                 luabridge::LuaRef lua_mgr = luabridge::getGlobal (L, "manager");
968                 lua.do_command ("manager = nil"); // hide it.
969                 lua.do_command ("collectgarbage()");
970
971                 _lua_add_action = new luabridge::LuaRef(lua_mgr["add"]);
972                 _lua_del_action = new luabridge::LuaRef(lua_mgr["remove"]);
973                 _lua_get_action = new luabridge::LuaRef(lua_mgr["get"]);
974                 _lua_call_action = new luabridge::LuaRef(lua_mgr["call"]);
975                 _lua_save = new luabridge::LuaRef(lua_mgr["save"]);
976                 _lua_load = new luabridge::LuaRef(lua_mgr["restore"]);
977                 _lua_clear = new luabridge::LuaRef(lua_mgr["clear"]);
978
979         } catch (luabridge::LuaException const& e) {
980                 fatal << string_compose (_("programming error: %1"),
981                                 X_("Failed to setup Lua action interpreter"))
982                         << endmsg;
983                 abort(); /*NOTREACHED*/
984         }
985
986         register_classes (L);
987
988         luabridge::push <PublicEditor *> (L, &PublicEditor::instance());
989         lua_setglobal (L, "Editor");
990 }
991
992 void LuaInstance::set_session (Session* s)
993 {
994         SessionHandlePtr::set_session (s);
995         if (!_session) {
996                 return;
997         }
998
999         lua_State* L = lua.getState();
1000         LuaBindings::set_session (L, _session);
1001
1002         for (LuaCallbackMap::iterator i = _callbacks.begin(); i != _callbacks.end(); ++i) {
1003                 i->second->set_session (s);
1004         }
1005         point_one_second_connection = Timers::rapid_connect (sigc::mem_fun(*this, & LuaInstance::every_point_one_seconds));
1006 }
1007
1008 void
1009 LuaInstance::session_going_away ()
1010 {
1011         ENSURE_GUI_THREAD (*this, &LuaInstance::session_going_away);
1012         point_one_second_connection.disconnect ();
1013
1014         (*_lua_clear)();
1015         for (int i = 0; i < 9; ++i) {
1016                 ActionChanged (i, ""); /* EMIT SIGNAL */
1017         }
1018         SessionHandlePtr::session_going_away ();
1019         _session = 0;
1020
1021         lua_State* L = lua.getState();
1022         LuaBindings::set_session (L, _session);
1023         lua.do_command ("collectgarbage();");
1024 }
1025
1026 void
1027 LuaInstance::every_point_one_seconds ()
1028 {
1029         LuaTimerDS (); // emit signal
1030 }
1031
1032 int
1033 LuaInstance::set_state (const XMLNode& node)
1034 {
1035         LocaleGuard lg;
1036         XMLNode* child;
1037
1038         if ((child = find_named_node (node, "ActionScript"))) {
1039                 for (XMLNodeList::const_iterator n = child->children ().begin (); n != child->children ().end (); ++n) {
1040                         if (!(*n)->is_content ()) { continue; }
1041                         gsize size;
1042                         guchar* buf = g_base64_decode ((*n)->content ().c_str (), &size);
1043                         try {
1044                                 (*_lua_load)(std::string ((const char*)buf, size));
1045                         } catch (luabridge::LuaException const& e) {
1046                                 cerr << "LuaException:" << e.what () << endl;
1047                         }
1048                         for (int i = 0; i < 9; ++i) {
1049                                 std::string name;
1050                                 if (lua_action_name (i, name)) {
1051                                         ActionChanged (i, name); /* EMIT SIGNAL */
1052                                 }
1053                         }
1054                         g_free (buf);
1055                 }
1056         }
1057
1058         if ((child = find_named_node (node, "ActionHooks"))) {
1059                 for (XMLNodeList::const_iterator n = child->children ().begin (); n != child->children ().end (); ++n) {
1060                         try {
1061                                 LuaCallbackPtr p (new LuaCallback (_session, *(*n)));
1062                                 _callbacks.insert (std::make_pair(p->id(), p));
1063                                 p->drop_callback.connect (_slotcon, MISSING_INVALIDATOR, boost::bind (&LuaInstance::unregister_lua_slot, this, p->id()), gui_context());
1064                                 SlotChanged (p->id(), p->name(), p->signals()); /* EMIT SIGNAL */
1065                         } catch (luabridge::LuaException const& e) {
1066                                 cerr << "LuaException:" << e.what () << endl;
1067                         }
1068                 }
1069         }
1070
1071         return 0;
1072 }
1073
1074 bool
1075 LuaInstance::interactive_add (LuaScriptInfo::ScriptType type, int id)
1076 {
1077         std::string title;
1078         std::vector<std::string> reg;
1079
1080         switch (type) {
1081                 case LuaScriptInfo::EditorAction:
1082                         reg = lua_action_names ();
1083                         title = "Add Lua Action";
1084                         break;
1085                 case LuaScriptInfo::EditorHook:
1086                         reg = lua_slot_names ();
1087                         title = "Add Lua Callback Hook";
1088                         break;
1089                 default:
1090                         return false;
1091         }
1092
1093         LuaScriptInfoPtr spi;
1094         ScriptSelector ss (title, type);
1095         switch (ss.run ()) {
1096                 case Gtk::RESPONSE_ACCEPT:
1097                         spi = ss.script();
1098                         break;
1099                 default:
1100                         return false;
1101         }
1102         ss.hide ();
1103
1104         std::string script = "";
1105
1106         try {
1107                 script = Glib::file_get_contents (spi->path);
1108         } catch (Glib::FileError e) {
1109                 string msg = string_compose (_("Cannot read script '%1': %2"), spi->path, e.what());
1110                 Gtk::MessageDialog am (msg);
1111                 am.run ();
1112                 return false;
1113         }
1114
1115         LuaScriptParamList lsp = LuaScriptParams::script_params (spi, "action_params");
1116
1117         ScriptParameterDialog spd (_("Set Script Parameters"), spi, reg, lsp);
1118         switch (spd.run ()) {
1119                 case Gtk::RESPONSE_ACCEPT:
1120                         break;
1121                 default:
1122                         return false;
1123         }
1124
1125         switch (type) {
1126                 case LuaScriptInfo::EditorAction:
1127                         return set_lua_action (id, spd.name(), script, lsp);
1128                         break;
1129                 case LuaScriptInfo::EditorHook:
1130                         return register_lua_slot (spd.name(), script, lsp);
1131                         break;
1132                 default:
1133                         break;
1134         }
1135         return false;
1136 }
1137
1138 XMLNode&
1139 LuaInstance::get_action_state ()
1140 {
1141         LocaleGuard lg;
1142         std::string saved;
1143         {
1144                 luabridge::LuaRef savedstate ((*_lua_save)());
1145                 saved = savedstate.cast<std::string>();
1146         }
1147         lua.collect_garbage ();
1148
1149         gchar* b64 = g_base64_encode ((const guchar*)saved.c_str (), saved.size ());
1150         std::string b64s (b64);
1151         g_free (b64);
1152
1153         XMLNode* script_node = new XMLNode (X_("ActionScript"));
1154         script_node->add_property (X_("lua"), LUA_VERSION);
1155         script_node->add_content (b64s);
1156
1157         return *script_node;
1158 }
1159
1160 XMLNode&
1161 LuaInstance::get_hook_state ()
1162 {
1163         XMLNode* script_node = new XMLNode (X_("ActionHooks"));
1164         for (LuaCallbackMap::const_iterator i = _callbacks.begin(); i != _callbacks.end(); ++i) {
1165                 script_node->add_child_nocopy (i->second->get_state ());
1166         }
1167         return *script_node;
1168 }
1169
1170 void
1171 LuaInstance::call_action (const int id)
1172 {
1173         try {
1174                 (*_lua_call_action)(id + 1);
1175                 lua.collect_garbage_step ();
1176         } catch (luabridge::LuaException const& e) {
1177                 cerr << "LuaException:" << e.what () << endl;
1178         }
1179 }
1180
1181 bool
1182 LuaInstance::set_lua_action (
1183                 const int id,
1184                 const std::string& name,
1185                 const std::string& script,
1186                 const LuaScriptParamList& args)
1187 {
1188         try {
1189                 lua_State* L = lua.getState();
1190                 // get bytcode of factory-function in a sandbox
1191                 // (don't allow scripts to interfere)
1192                 const std::string& bytecode = LuaScripting::get_factory_bytecode (script);
1193                 luabridge::LuaRef tbl_arg (luabridge::newTable(L));
1194                 for (LuaScriptParamList::const_iterator i = args.begin(); i != args.end(); ++i) {
1195                         if ((*i)->optional && !(*i)->is_set) { continue; }
1196                         tbl_arg[(*i)->name] = (*i)->value;
1197                 }
1198                 (*_lua_add_action)(id + 1, name, script, bytecode, tbl_arg);
1199                 ActionChanged (id, name); /* EMIT SIGNAL */
1200         } catch (luabridge::LuaException const& e) {
1201                 cerr << "LuaException:" << e.what () << endl;
1202                 return false;
1203         }
1204         return true;
1205 }
1206
1207 bool
1208 LuaInstance::remove_lua_action (const int id)
1209 {
1210         try {
1211                 (*_lua_del_action)(id + 1);
1212         } catch (luabridge::LuaException const& e) {
1213                 cerr << "LuaException:" << e.what () << endl;
1214                 return false;
1215         }
1216         ActionChanged (id, ""); /* EMIT SIGNAL */
1217         return true;
1218 }
1219
1220 bool
1221 LuaInstance::lua_action_name (const int id, std::string& rv)
1222 {
1223         try {
1224                 luabridge::LuaRef ref ((*_lua_get_action)(id + 1));
1225                 if (ref.isNil()) {
1226                         return false;
1227                 }
1228                 if (ref["name"].isString()) {
1229                         rv = ref["name"].cast<std::string>();
1230                         return true;
1231                 }
1232                 return true;
1233         } catch (luabridge::LuaException const& e) {
1234                 cerr << "LuaException:" << e.what () << endl;
1235                 return false;
1236         }
1237         return false;
1238 }
1239
1240 std::vector<std::string>
1241 LuaInstance::lua_action_names ()
1242 {
1243         std::vector<std::string> rv;
1244         for (int i = 0; i < 9; ++i) {
1245                 std::string name;
1246                 if (lua_action_name (i, name)) {
1247                         rv.push_back (name);
1248                 }
1249         }
1250         return rv;
1251 }
1252
1253 bool
1254 LuaInstance::lua_action (const int id, std::string& name, std::string& script, LuaScriptParamList& args)
1255 {
1256         try {
1257                 luabridge::LuaRef ref ((*_lua_get_action)(id + 1));
1258                 if (ref.isNil()) {
1259                         return false;
1260                 }
1261                 if (!ref["name"].isString()) {
1262                         return false;
1263                 }
1264                 if (!ref["script"].isString()) {
1265                         return false;
1266                 }
1267                 if (!ref["args"].isTable()) {
1268                         return false;
1269                 }
1270                 name = ref["name"].cast<std::string>();
1271                 script = ref["script"].cast<std::string>();
1272
1273                 args.clear();
1274                 LuaScriptInfoPtr lsi = LuaScripting::script_info (script);
1275                 if (!lsi) {
1276                         return false;
1277                 }
1278                 args = LuaScriptParams::script_params (lsi, "action_params");
1279                 luabridge::LuaRef rargs (ref["args"]);
1280                 LuaScriptParams::ref_to_params (args, &rargs);
1281                 return true;
1282         } catch (luabridge::LuaException const& e) {
1283                 cerr << "LuaException:" << e.what () << endl;
1284                 return false;
1285         }
1286         return false;
1287 }
1288
1289 bool
1290 LuaInstance::register_lua_slot (const std::string& name, const std::string& script, const ARDOUR::LuaScriptParamList& args)
1291 {
1292         /* parse script, get ActionHook(s) from script */
1293         ActionHook ah;
1294         try {
1295                 LuaState l;
1296 #ifndef NDEBUG
1297                 l.Print.connect (&_lua_print);
1298 #endif
1299                 lua_State* L = l.getState();
1300                 register_hooks (L);
1301                 l.do_command ("function ardour () end");
1302                 l.do_command (script);
1303                 luabridge::LuaRef signals = luabridge::getGlobal (L, "signals");
1304                 if (signals.isFunction()) {
1305                         ah = signals();
1306                 }
1307         } catch (luabridge::LuaException const& e) {
1308                 cerr << "LuaException:" << e.what () << endl;
1309         }
1310
1311         if (ah.none ()) {
1312                 cerr << "Script registered no hooks." << endl;
1313                 return false;
1314         }
1315
1316         /* register script w/args, get entry-point / ID */
1317
1318         try {
1319                 LuaCallbackPtr p (new LuaCallback (_session, name, script, ah, args));
1320                 _callbacks.insert (std::make_pair(p->id(), p));
1321                 p->drop_callback.connect (_slotcon, MISSING_INVALIDATOR, boost::bind (&LuaInstance::unregister_lua_slot, this, p->id()), gui_context());
1322                 SlotChanged (p->id(), p->name(), p->signals()); /* EMIT SIGNAL */
1323                 return true;
1324         } catch (luabridge::LuaException const& e) {
1325                 cerr << "LuaException:" << e.what () << endl;
1326         }
1327         return false;
1328 }
1329
1330 bool
1331 LuaInstance::unregister_lua_slot (const PBD::ID& id)
1332 {
1333         LuaCallbackMap::iterator i = _callbacks.find (id);
1334         if (i != _callbacks.end()) {
1335                 SlotChanged (id, "", ActionHook()); /* EMIT SIGNAL */
1336                 _callbacks.erase (i);
1337                 return true;
1338         }
1339         return false;
1340 }
1341
1342 std::vector<PBD::ID>
1343 LuaInstance::lua_slots () const
1344 {
1345         std::vector<PBD::ID> rv;
1346         for (LuaCallbackMap::const_iterator i = _callbacks.begin(); i != _callbacks.end(); ++i) {
1347                 rv.push_back (i->first);
1348         }
1349         return rv;
1350 }
1351
1352 bool
1353 LuaInstance::lua_slot_name (const PBD::ID& id, std::string& name) const
1354 {
1355         LuaCallbackMap::const_iterator i = _callbacks.find (id);
1356         if (i != _callbacks.end()) {
1357                 name = i->second->name();
1358                 return true;
1359         }
1360         return false;
1361 }
1362
1363 std::vector<std::string>
1364 LuaInstance::lua_slot_names () const
1365 {
1366         std::vector<std::string> rv;
1367         std::vector<PBD::ID> ids = lua_slots();
1368         for (std::vector<PBD::ID>::const_iterator i = ids.begin(); i != ids.end(); ++i) {
1369                 std::string name;
1370                 if (lua_slot_name (*i, name)) {
1371                         rv.push_back (name);
1372                 }
1373         }
1374         return rv;
1375 }
1376
1377 bool
1378 LuaInstance::lua_slot (const PBD::ID& id, std::string& name, std::string& script, ActionHook& ah, ARDOUR::LuaScriptParamList& args)
1379 {
1380         LuaCallbackMap::const_iterator i = _callbacks.find (id);
1381         if (i == _callbacks.end()) {
1382                 return false; // error
1383         }
1384         return i->second->lua_slot (name, script, ah, args);
1385 }
1386
1387 ///////////////////////////////////////////////////////////////////////////////
1388
1389 LuaCallback::LuaCallback (Session *s,
1390                 const std::string& name,
1391                 const std::string& script,
1392                 const ActionHook& ah,
1393                 const ARDOUR::LuaScriptParamList& args)
1394         : SessionHandlePtr (s)
1395         , _id ("0")
1396         , _name (name)
1397         , _signals (ah)
1398 {
1399         // TODO: allow to reference object (e.g region)
1400         init ();
1401
1402         lua_State* L = lua.getState();
1403         luabridge::LuaRef tbl_arg (luabridge::newTable(L));
1404         for (LuaScriptParamList::const_iterator i = args.begin(); i != args.end(); ++i) {
1405                 if ((*i)->optional && !(*i)->is_set) { continue; }
1406                 tbl_arg[(*i)->name] = (*i)->value;
1407         }
1408
1409         try {
1410         const std::string& bytecode = LuaScripting::get_factory_bytecode (script);
1411         (*_lua_add)(name, script, bytecode, tbl_arg);
1412         } catch (luabridge::LuaException const& e) {
1413                 cerr << "LuaException:" << e.what () << endl;
1414                 throw failed_constructor ();
1415         }
1416
1417         _id.reset ();
1418         set_session (s);
1419 }
1420
1421 LuaCallback::LuaCallback (Session *s, XMLNode & node)
1422         : SessionHandlePtr (s)
1423 {
1424         XMLNode* child = NULL;
1425         if (node.name() != X_("LuaCallback")
1426                         || !node.property ("signals")
1427                         || !node.property ("id")
1428                         || !node.property ("name")) {
1429                 throw failed_constructor ();
1430         }
1431
1432         for (XMLNodeList::const_iterator n = node.children ().begin (); n != node.children ().end (); ++n) {
1433                 if (!(*n)->is_content ()) { continue; }
1434                 child = *n;
1435         }
1436
1437         if (!child) {
1438                 throw failed_constructor ();
1439         }
1440
1441         init ();
1442
1443         _id = PBD::ID (node.property ("id")->value ());
1444         _name = node.property ("name")->value ();
1445         _signals = ActionHook (node.property ("signals")->value ());
1446
1447         gsize size;
1448         guchar* buf = g_base64_decode (child->content ().c_str (), &size);
1449         try {
1450                 (*_lua_load)(std::string ((const char*)buf, size));
1451         } catch (luabridge::LuaException const& e) {
1452                 cerr << "LuaException:" << e.what () << endl;
1453         }
1454         g_free (buf);
1455
1456         set_session (s);
1457 }
1458
1459 LuaCallback::~LuaCallback ()
1460 {
1461         delete _lua_add;
1462         delete _lua_get;
1463         delete _lua_call;
1464         delete _lua_load;
1465         delete _lua_save;
1466 }
1467
1468 XMLNode&
1469 LuaCallback::get_state (void)
1470 {
1471         std::string saved;
1472         {
1473                 luabridge::LuaRef savedstate ((*_lua_save)());
1474                 saved = savedstate.cast<std::string>();
1475         }
1476         lua.collect_garbage ();
1477
1478         gchar* b64 = g_base64_encode ((const guchar*)saved.c_str (), saved.size ());
1479         std::string b64s (b64);
1480         g_free (b64);
1481
1482         XMLNode* script_node = new XMLNode (X_("LuaCallback"));
1483         script_node->add_property (X_("lua"), LUA_VERSION);
1484         script_node->add_property (X_("id"), _id.to_s ());
1485         script_node->add_property (X_("name"), _name);
1486         script_node->add_property (X_("signals"), _signals.to_string ());
1487         script_node->add_content (b64s);
1488         return *script_node;
1489 }
1490
1491 void
1492 LuaCallback::init (void)
1493 {
1494 #ifndef NDEBUG
1495         lua.Print.connect (&_lua_print);
1496 #endif
1497
1498         lua.do_command (
1499                         "function ScriptManager ()"
1500                         "  local self = { script = {}, instance = {} }"
1501                         ""
1502                         "  local addinternal = function (n, s, f, a)"
1503                         "   assert(type(n) == 'string', 'Name must be string')"
1504                         "   assert(type(s) == 'string', 'Script must be string')"
1505                         "   assert(type(f) == 'function', 'Factory is a not a function')"
1506                         "   assert(type(a) == 'table' or type(a) == 'nil', 'Given argument is invalid')"
1507                         "   self.script = { ['n'] = n, ['s'] = s, ['f'] = f, ['a'] = a }"
1508                         "   local env = _ENV;  env.f = nil env.debug = nil os.exit = nil require = nil dofile = nil loadfile = nil package = nil"
1509                         "   self.instance = load (string.dump(f, true), nil, nil, env)(a)"
1510                         "  end"
1511                         ""
1512                         "  local call = function (...)"
1513                         "   if type(self.instance) == 'function' then"
1514                         "     local status, err = pcall (self.instance, ...)"
1515                         "     if not status then"
1516                         "       print ('callback \"'.. self.script['n'] .. '\": ', err)" // error out
1517                         "       self.script = nil"
1518                         "       self.instance = nil"
1519                         "       return false"
1520                         "     end"
1521                         "   end"
1522                         "   collectgarbage()"
1523                         "   return true"
1524                         "  end"
1525                         ""
1526                         "  local add = function (n, s, b, a)"
1527                         "   assert(type(b) == 'string', 'ByteCode must be string')"
1528                         "   load (b)()" // assigns f
1529                         "   assert(type(f) == 'string', 'Assigned ByteCode must be string')"
1530                         "   addinternal (n, s, load(f), a)"
1531                         "  end"
1532                         ""
1533                         "  local get = function ()"
1534                         "   if type(self.instance) == 'function' and type(self.script['n']) == 'string' then"
1535                         "    return { ['name'] = self.script['n'],"
1536                         "             ['script'] = self.script['s'],"
1537                         "             ['args'] = self.script['a'] }"
1538                         "   end"
1539                         "   return nil"
1540                         "  end"
1541                         ""
1542                         // code dup
1543                         ""
1544                         "  local function basic_serialize (o)"
1545                         "    if type(o) == \"number\" then"
1546                         "     return tostring(o)"
1547                         "    else"
1548                         "     return string.format(\"%q\", o)"
1549                         "    end"
1550                         "  end"
1551                         ""
1552                         "  local function serialize (name, value)"
1553                         "   local rv = name .. ' = '"
1554                         "   collectgarbage()"
1555                         "   if type(value) == \"number\" or type(value) == \"string\" or type(value) == \"nil\" then"
1556                         "    return rv .. basic_serialize(value) .. ' '"
1557                         "   elseif type(value) == \"table\" then"
1558                         "    rv = rv .. '{} '"
1559                         "    for k,v in pairs(value) do"
1560                         "     local fieldname = string.format(\"%s[%s]\", name, basic_serialize(k))"
1561                         "     rv = rv .. serialize(fieldname, v) .. ' '"
1562                         "     collectgarbage()" // string concatenation allocates a new string
1563                         "    end"
1564                         "    return rv;"
1565                         "   elseif type(value) == \"function\" then"
1566                         "     return rv .. string.format(\"%q\", string.dump(value, true))"
1567                         "   else"
1568                         "    error('cannot save a ' .. type(value))"
1569                         "   end"
1570                         "  end"
1571                         ""
1572                         // end code dup
1573                         ""
1574                         "  local save = function ()"
1575                         "   return (serialize('s', self.script))"
1576                         "  end"
1577                         ""
1578                         "  local restore = function (state)"
1579                         "   self.script = {}"
1580                         "   load (state)()"
1581                         "   addinternal (s['n'], s['s'], load(s['f']), s['a'])"
1582                         "  end"
1583                         ""
1584                         " return { call = call, add = add, get = get,"
1585                         "          restore = restore, save = save}"
1586                         " end"
1587                         " "
1588                         " manager = ScriptManager ()"
1589                         " ScriptManager = nil"
1590                         );
1591
1592         lua_State* L = lua.getState();
1593
1594         try {
1595                 luabridge::LuaRef lua_mgr = luabridge::getGlobal (L, "manager");
1596                 lua.do_command ("manager = nil"); // hide it.
1597                 lua.do_command ("collectgarbage()");
1598
1599                 _lua_add = new luabridge::LuaRef(lua_mgr["add"]);
1600                 _lua_get = new luabridge::LuaRef(lua_mgr["get"]);
1601                 _lua_call = new luabridge::LuaRef(lua_mgr["call"]);
1602                 _lua_save = new luabridge::LuaRef(lua_mgr["save"]);
1603                 _lua_load = new luabridge::LuaRef(lua_mgr["restore"]);
1604
1605         } catch (luabridge::LuaException const& e) {
1606                 fatal << string_compose (_("programming error: %1"),
1607                                 X_("Failed to setup Lua callback interpreter"))
1608                         << endmsg;
1609                 abort(); /*NOTREACHED*/
1610         }
1611
1612         LuaInstance::register_classes (L);
1613
1614         luabridge::push <PublicEditor *> (L, &PublicEditor::instance());
1615         lua_setglobal (L, "Editor");
1616 }
1617
1618 bool
1619 LuaCallback::lua_slot (std::string& name, std::string& script, ActionHook& ah, ARDOUR::LuaScriptParamList& args)
1620 {
1621         // TODO consolidate w/ LuaInstance::lua_action()
1622         try {
1623                 luabridge::LuaRef ref = (*_lua_get)();
1624                 if (ref.isNil()) {
1625                         return false;
1626                 }
1627                 if (!ref["name"].isString()) {
1628                         return false;
1629                 }
1630                 if (!ref["script"].isString()) {
1631                         return false;
1632                 }
1633                 if (!ref["args"].isTable()) {
1634                         return false;
1635                 }
1636
1637                 ah = _signals;
1638                 name = ref["name"].cast<std::string> ();
1639                 script = ref["script"].cast<std::string> ();
1640
1641                 args.clear();
1642                 LuaScriptInfoPtr lsi = LuaScripting::script_info (script);
1643                 if (!lsi) {
1644                         return false;
1645                 }
1646                 args = LuaScriptParams::script_params (lsi, "action_params");
1647                 luabridge::LuaRef rargs (ref["args"]);
1648                 LuaScriptParams::ref_to_params (args, &rargs);
1649                 return true;
1650         } catch (luabridge::LuaException const& e) {
1651                 cerr << "LuaException:" << e.what () << endl;
1652                 return false;
1653         }
1654         return false;
1655 }
1656
1657 void
1658 LuaCallback::set_session (ARDOUR::Session *s)
1659 {
1660         SessionHandlePtr::set_session (s);
1661
1662         if (!_session) {
1663                 return;
1664         }
1665
1666         lua_State* L = lua.getState();
1667         LuaBindings::set_session (L, _session);
1668
1669         reconnect();
1670 }
1671
1672 void
1673 LuaCallback::session_going_away ()
1674 {
1675         ENSURE_GUI_THREAD (*this, &LuaCallback::session_going_away);
1676         lua.do_command ("collectgarbage();");
1677
1678         SessionHandlePtr::session_going_away ();
1679         _session = 0;
1680
1681         drop_callback (); /* EMIT SIGNAL */
1682
1683         lua_State* L = lua.getState();
1684         LuaBindings::set_session (L, 0);
1685         lua.do_command ("collectgarbage();");
1686 }
1687
1688 void
1689 LuaCallback::reconnect ()
1690 {
1691         _connections.drop_connections ();
1692         if ((*_lua_get) ().isNil ()) {
1693                 drop_callback (); /* EMIT SIGNAL */
1694                 return;
1695         }
1696
1697         // TODO pass object which emits the signal (e.g region)
1698         //
1699         // save/load bound objects will be tricky.
1700         // Best idea so far is to save/lookup the PBD::ID
1701         // (either use boost::any indirection or templates for bindable
1702         // object types or a switch statement..)
1703         //
1704         // _session->route_by_id ()
1705         // _session->track_by_diskstream_id ()
1706         // _session->source_by_id ()
1707         // _session->controllable_by_id ()
1708         // _session->processor_by_id ()
1709         // RegionFactory::region_by_id ()
1710         //
1711         // TODO loop over objects (if any)
1712
1713         reconnect_object ((void*)0);
1714 }
1715
1716 template <class T> void
1717 LuaCallback::reconnect_object (T obj)
1718 {
1719         for (uint32_t i = 0; i < LuaSignal::LAST_SIGNAL; ++i) {
1720                 if (_signals[i]) {
1721 #define ENGINE(n,c,p) else if (i == LuaSignal::n) { connect_ ## p (LuaSignal::n, AudioEngine::instance(), &(AudioEngine::instance()->c)); }
1722 #define SESSION(n,c,p) else if (i == LuaSignal::n) { if (_session) { connect_ ## p (LuaSignal::n, _session, &(_session->c)); } }
1723 #define STATIC(n,c,p) else if (i == LuaSignal::n) { connect_ ## p (LuaSignal::n, obj, c); }
1724                         if (0) {}
1725 #                       include "luasignal_syms.h"
1726                         else {
1727                                 PBD::fatal << string_compose (_("programming error: %1: %2"), "Impossible LuaSignal type", i) << endmsg;
1728                                 abort(); /*NOTREACHED*/
1729                         }
1730 #undef ENGINE
1731 #undef SESSION
1732 #undef STATIC
1733                 }
1734         }
1735 }
1736
1737 template <typename T, typename S> void
1738 LuaCallback::connect_0 (enum LuaSignal::LuaSignal ls, T ref, S *signal) {
1739         signal->connect (
1740                         _connections, invalidator (*this),
1741                         boost::bind (&LuaCallback::proxy_0<T>, this, ls, ref),
1742                         gui_context());
1743 }
1744
1745 template <typename T, typename C1> void
1746 LuaCallback::connect_1 (enum LuaSignal::LuaSignal ls, T ref, PBD::Signal1<void, C1> *signal) {
1747         signal->connect (
1748                         _connections, invalidator (*this),
1749                         boost::bind (&LuaCallback::proxy_1<T, C1>, this, ls, ref, _1),
1750                         gui_context());
1751 }
1752
1753 template <typename T, typename C1, typename C2> void
1754 LuaCallback::connect_2 (enum LuaSignal::LuaSignal ls, T ref, PBD::Signal2<void, C1, C2> *signal) {
1755         signal->connect (
1756                         _connections, invalidator (*this),
1757                         boost::bind (&LuaCallback::proxy_2<T, C1, C2>, this, ls, ref, _1, _2),
1758                         gui_context());
1759 }
1760
1761 template <typename T> void
1762 LuaCallback::proxy_0 (enum LuaSignal::LuaSignal ls, T ref) {
1763         bool ok = true;
1764         {
1765                 const luabridge::LuaRef& rv ((*_lua_call)((int)ls, ref));
1766                 if (! rv.cast<bool> ()) {
1767                         ok = false;
1768                 }
1769         }
1770         /* destroy LuaRef ^^ first before calling drop_callback() */
1771         if (!ok) {
1772                 drop_callback (); /* EMIT SIGNAL */
1773         }
1774 }
1775
1776 template <typename T, typename C1> void
1777 LuaCallback::proxy_1 (enum LuaSignal::LuaSignal ls, T ref, C1 a1) {
1778         bool ok = true;
1779         {
1780                 const luabridge::LuaRef& rv ((*_lua_call)((int)ls, ref, a1));
1781                 if (! rv.cast<bool> ()) {
1782                         ok = false;
1783                 }
1784         }
1785         if (!ok) {
1786                 drop_callback (); /* EMIT SIGNAL */
1787         }
1788 }
1789
1790 template <typename T, typename C1, typename C2> void
1791 LuaCallback::proxy_2 (enum LuaSignal::LuaSignal ls, T ref, C1 a1, C2 a2) {
1792         bool ok = true;
1793         {
1794                 const luabridge::LuaRef& rv ((*_lua_call)((int)ls, ref, a1, a2));
1795                 if (! rv.cast<bool> ()) {
1796                         ok = false;
1797                 }
1798         }
1799         if (!ok) {
1800                 drop_callback (); /* EMIT SIGNAL */
1801         }
1802 }