uappli.hpp

/************************************************************************
 *
 *  uappli.hpp: Appplication Context (must be created first)
 *  Ubit GUI Toolkit - Version 6
 *  (C) 2009 | Eric Lecolinet | TELECOM ParisTech | http://www.enst.fr/~elc/ubit
 *
 * ***********************************************************************
 * COPYRIGHT NOTICE :
 * THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY AND WITHOUT EVEN THE
 * IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 * 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 FILES 'COPYRIGHT' AND 'COPYING' FOR MORE DETAILS.
 * ***********************************************************************/

#ifndef _uappli_hpp_
#define _uappli_hpp_ 1
#include <cstdio>
#include <cstdarg>
#include <ubit/udisp.hpp>
#include <ubit/uconf.hpp>
namespace ubit {
  
  typedef std::vector<UEventFlow*> UFlowList;
  
  
  typedef std::vector<UDisp*> UDispList;
  
      
  class UAppli {
  public:
    static UConf conf;
    UAppli(int& argc, char** argv,
           UOption* command_line_options = null, 
           const char* configuration_file = null);
    virtual ~UAppli();
    
    static UAppli& appli();
    static UAppli* getAppli();
    static UConf& getConf() {return conf;}
    
    static const char* getVersion();
    
    static bool isUsingGL() {return conf.is_using_gl;}
    
    static bool isRunning();
    
    static bool isExiting();
    
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    static void add(UWin&);
    static void add(UWin*);
    
    static void remove(UWin& win, bool auto_delete = true);
    static void remove(UWin*, bool auto_delete = true);
    
    static int start();
    static void quit(int status = 0);
    static UFrame* getMainFrame();
    static const UStr& getName();
    
    static UStr getTitle();
    
    static void setTitle(const UStr& title);
    
    static void setFocus(UView*);
    static void updateAll(const UUpdate& mode = UUpdate::layoutAndPaint); 
    // - - - Errors and warnings - - - - - - - - - - - - - - - - - - - - - - - -
        
    static UErrorHandler& getErrorHandler();
    
    static void setErrorHandler(UErrorHandler&);
        
    
    static void error(const char* funcname, const char* format, ...);
    
    static void warning(const char* funcname, const char* format, ...);
    
    static void fatalError(const char* funcname, const char* format, ...);
     
    
    static void raiseError(int errnum, const UObject*, 
                           const char* funcname, const char* format, ...);
    static void raiseError(int errnum, const UObject*, 
                           const char* funcname, const char* format, va_list);

    
    // - - - Time and Timeouts - - - - - - - - - - - - - - - - - - - - - - - - -
    
    static unsigned long getTime();
    
    static void setMotionLag(unsigned long app_lag, unsigned long nat_lag);
    static void addTimeout(unsigned long msec_delay, int ntimes, UCall& callback);
    static void postpone(UCall& callback);
    // - - - Displays and Event Flows  - - - - - - - - - - - - - - - - - - - - -
    
    static UDisp* getDisp();
    
    static UDisp* getDisp(int ID);
    static const UDispList& getDispList();
    //< returns the list of Displays that are connected with this UAppli.
    
    static UDisp* openDisp(const UStr& display_name);
    static void closeDisp(UDisp*);
    
    static UEventFlow* getFlow(int ID = 0);
    static const UFlowList& getFlowList();
    
    static USelection* getSelection(int ID = 0);
    // - - - Inter-client Messages - - - - - - - - - - - - - - - - - - - - - - -
    
    static void onMessage(const UStr& port_name, UCall& callback);
    static UMessagePort& getMessagePort(const UStr& name);
    
    static UMessagePort* findMessagePort(const UStr& name);
    
    static UMessagePortMap* getMessagePortMap();
    
    
    // - - - Misc - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
    
    static const UStr& getImaPath();
    
    static void setImaPath(const UStr& pathname);
    static UStyleSheet& getStyleSheet();
    
    static const UStyle& getDefaultStyle();
    
    UMenu* getOpenedMenu();
    
    static bool hasTelePointers();
    
    // - - - Impl - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
    
    friend class UEventFlow;
    
    static class UAppliImpl& impl;
    
    UStr& initConf(int& argc, char** argv, UOption*, const char* confile);
    
    static void internalError(const char* fun, const char* format, ...);

    static void deleteNotify(UDisp*);
    
    static void deleteNotify(UElem*);

    static void deleteNotify(UView*);
  };
  
  
  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  class UErrorHandler : public UObject {
  public:
    UCLASSDEF("UErrorHandler", UErrorHandler, null)
    
    UErrorHandler(const UStr& label, std::ostream* out_stream = &std::cerr);
    virtual ~UErrorHandler();
    
    virtual void setOutputStream(std::ostream*);
    
    virtual void setOutputBuffer(UStr*);
    
    UStr& label() {return *plabel;}
    
    virtual void warning(const char* funcname, const char* format, ...) const;
    
    virtual void error(const char* funcname, const char* format, ...) const;
    
    virtual void error(int errnum, const UObject*, const char* funcname, 
                       const char* format, ...) const;
    
    virtual void parserError(int errnum, const UChar* text_buffer,
                                  const char* msg_start, const UStr& name,
                                  const char* msg_end, const UChar* line) const;
    
    virtual void raiseError(int errnum, const UObject*, const char* funcname, 
                            const char* format, va_list) const;
    virtual void raiseError(int errnum, UStr* msg) const;

    virtual const char* getErrorName(int errnum) const;
    virtual void formatMessage(UError&, const char* format, va_list) const;
    virtual void printOnStream(const UError&) const;
    virtual void printOnBuffer(const UError&) const;
    
  protected:
    uptr<UStr> plabel;
    uptr<UStr> pbuffer;
    std::ostream* fout;
  };
  
}
#endif