umservice.hpp

/* ==================================================== ======== ======= *
*
*  umservice.hpp: acess to the UMS (Ubit Mouse/Message Server) services 
*  Ubit Project
*  Part of the Ubit Toolkit: A Brick Construction Game Model for Creating GUIs
*  (C) 1999-2006 / EricLecolinet / ENST Paris / 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.
* ***********************************************************************
* ==================================================== [(c)Elc] ======= *
* ==================================================== ======== ======= */

#ifndef _umservice_hpp_
#define _umservice_hpp_
//pragma ident  "@(#)umservice.hpp      ubit:05.05.00"
#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, unsigned long keysym);
  bool releaseKey(int event_flow, unsigned long keysym);
  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 

  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
/* ==================================================== [TheEnd] ======= */
/* ==================================================== ======== ======= */

---