gtk-lumiera.cpp

Go to the documentation of this file.

/*
  GtkLumiera  -  entry point for the lumiera GUI loaded as shared module
 
   Copyright (C)
     2007-2008,       Joel Holdsworth <joel@airwebreathe.org.uk>
     2009,            Hermann Vosseler <Ichthyostega@web.de>
     2016,2017        Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** 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 2 of the License, or (at your
 option) any later version. See the file COPYING for further details.
 
* *****************************************************************/
 
 
#include "stage/gtk-base.hpp"
 
#include "lib/error.hpp"
#include "lib/thread.hpp"
#include "stage/ui-bus.hpp"
#include "stage/guifacade.hpp"
#include "stage/ctrl/ui-manager.hpp"
#include "common/subsys.hpp"
#include "lib/nocopy.hpp"
 
extern "C" {
#include "common/interface.h"
#include "common/interface-descriptor.h"
}
 
#include <string>
 
 
 
using lumiera::Subsys;
using lib::launchDetached;
using lumiera::error::LUMIERA_ERROR_STATE;
using stage::LUMIERA_INTERFACE_INAME(lumieraorg_Gui, 1);
 
using std::string;
 
 
namespace lumiera {
namespace error {
  /* == definition common error marks for the UI, declared in gtk-base.hpp == */
  LUMIERA_ERROR_DEFINE (UIWIRING, "GUI state contradicts assumptions in signal wiring");
}}
 
 
namespace stage {
  
  namespace { // implementation details
    
    using ctrl::UiManager;
    
    
    /**************************************************************************/
    class GtkLumiera
      : util::NonCopyable
      {
        UiBus     uiBus_;
        UiManager uiManager_;
        
      public:
        GtkLumiera ()
          : uiBus_{}
          , uiManager_{uiBus_}
          { }
        
        
        string
        run()
          {
            string errorMsgBuff;
            try
              {
                // execute the GTK Event Loop____________
                uiManager_.createApplicationWindow();
                uiManager_.performMainLoop();
              }                                        // all went well, regular shutdown
            
            catch (lumiera::Error& problem)
              {
                errorMsgBuff = problem.what();
                lumiera_error();                       // clear error flag
              }
            catch (...)
              {
                errorMsgBuff = "unexpected error terminated the GUI.";
              }
            if (lumiera_error_peek())
              errorMsgBuff = string{lumiera_error()};
            
            return errorMsgBuff;
          }
      };
    //(End) GUI-Thread.
  }//(End) impl details
  
  
  
  
  bool
  launchUI (Subsys::SigTerm& reportOnTermination)
  {
    try
      {
        launchDetached ("GUI-Main"
                       , [reportOnTermination]
                            {
                              string shutdownLog = GtkLumiera{}.run();
                               // inform main thread that the GUI has been shut down...
                              reportOnTermination (&shutdownLog);
                            });
        return true; // if we reach this line...
      }
    catch(...)
      {
        CStr errID = lumiera_error(); // clear C-style error flag
        WARN (stage, "Unexpected error while starting the GUI thread.");
        if (errID)
          TRACE (stage, "Error flag was: %s", errID);
        return false;
      }
  }
 
} // namespace stage
 
 
 
 
 
 
extern "C" { /* ================== define a lumieraorg_Gui instance ======================= */
  
  
  LUMIERA_INTERFACE_INSTANCE (lumieraorg_interfacedescriptor, 0
                             ,lumieraorg_GuiStarterPlugin_descriptor
                             , NULL, NULL, NULL
                             , LUMIERA_INTERFACE_INLINE (name,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "GuiStarterPlugin"; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (brief,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "entry point to start up the Lumiera GTK GUI contained in this dynamic module"; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (homepage,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "http://www.lumiera.org/develompent.html" ;}
                                                        )
                             , LUMIERA_INTERFACE_INLINE (version,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "0.1~pre"; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (author,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "Joel Holdsworth, Christian Thaeter, Hermann Vosseler"; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (email,
                                                         const char*, (LumieraInterface ifa),
                                                           { (void)ifa;  return "Lumiera@lists.lumiera.org"; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (copyright,
                                                         const char*, (LumieraInterface ifa),
                                                           {
                                                             (void)ifa;
                                                             return
                                                                 "Copyright (C)\n"
                                                                 "  2007-2008,       Joel Holdsworth <joel@airwebreathe.org.uk>\n"
                                                                 "  2009,            Christian Thaeter <ct@pipapo.org>\n"
                                                                 "  2009,            Hermann Vosseler <Ichthyostega@web.de>"
                                                                 "  2016,2017,       Hermann Vosseler <Ichthyostega@web.de>";
                                                           }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (license,
                                                         const char*, (LumieraInterface ifa),
                                                           {
                                                             (void)ifa;
                                                             return
                                                                 "**Lumiera** is free software; you can redistribute it and/or modify it\n"
                                                                 "under the terms of the GNU General Public License as published by the\n"
                                                                 "Free Software Foundation; either version 2 of the License, or (at your\n"
                                                                 "option) any later version. See the file COPYING for further details."
                                                                 ;
                                                           }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (state,
                                                         int, (LumieraInterface ifa),
                                                           {(void)ifa;  return LUMIERA_INTERFACE_EXPERIMENTAL; }
                                                        )
                             , LUMIERA_INTERFACE_INLINE (versioncmp,
                                                         int, (const char* a, const char* b),
                                                           {(void)a;(void)b;  return 0;}  
                                                        )
                             );
  
  
  LUMIERA_EXPORT( /* ===================== PLUGIN EXPORTS ================================== */
                 
                 LUMIERA_INTERFACE_DEFINE (lumieraorg_Gui, 1
                                          ,lumieraorg_GuiStarterPlugin
                                          , LUMIERA_INTERFACE_REF(lumieraorg_interfacedescriptor, 0, lumieraorg_GuiStarterPlugin_descriptor)
                                          , NULL  /* on open  */
                                          , NULL  /* on close */
                                          , LUMIERA_INTERFACE_INLINE (launchUI,
                                                                      bool, (void* termSig),
                                                                        {
                                                                          return stage::launchUI (*reinterpret_cast<Subsys::SigTerm *> (termSig));
                                                                        }
                                                                     )
                                          )
                );
 
} // extern "C"