umservice.hpp

/* ==================================================== ======== ======= *
 *
 *  umservice.hpp: acess to the UMS (Ubit Mouse/Message Server) services 
 *  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 _umservice_hpp_
#define _umservice_hpp_
#include <ubit/udefs.hpp>
#include <ubit/usocket.hpp>
namespace ubit {
  
  class UMService : public USocket {
  public:
    UMService(const UStr& host, int port = 0);
    ~UMService();
    
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    struct BrowseReply {
      BrowseReply(UMessageEvent&);
      int  flags, errorCode;
      long interfaceIndex;
      UStr serviceName, serviceType, replyDomain;
      int  status;
      bool isRemoved() {return status == false;}
      bool isAdded()   {return status == true;}
    };
    
    bool browseUMServers(UCall& callback);
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    struct ResolveReply {
      ResolveReply(UMessageEvent&);
      int  flags, errorCode;
      long interfaceIndex;
      UStr fullname, hosttarget; //, txtRecord;
      int  port;
    };
    
    bool resolveUMServer(const UStr& name, UCall& callback);
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    bool browseUMSNeighbors(UCall& callback);
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    //bool tactos(const char* data);
    // tactile output stream.
    
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    bool pressMouse(int event_flow, int button_id);
    bool releaseMouse(int event_flow, int button_id);
    bool moveMouse(int event_flow, int x, int y, bool absolute_coords);
    bool pressKey(int event_flow, int keycode);
    bool releaseKey(int event_flow, int keycode);
    // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
    
    bool sendMouseClick(const char* target, int x, int y, int button_id, int modifiers);
    bool sendMousePress(const char* target, int x, int y, int button_id, int modifiers);
    bool sendMouseRelease(const char* target, int x, int y, int button_id, int modifiers);
    bool sendMessage(const char* target, const UStr& message);
    bool sendMessage(const char* target, const char* message);
    bool sendRequest(int ums_request, const UStr& data);
    bool sendRequest(int ums_request, const char* data = null);
    
    // - - - impl. - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    UMService(const UStr& host, int port, const char* client_name);
    
    virtual void inputCallback();
    
  protected:
    uptr<UCall> browse_call, neighbor_call; 
  };
  
}
#endif