Client.H (5873B)
1 2 /*******************************************************************************/ 3 /* Copyright (C) 2012 Jonathan Moore Liles */ 4 /* */ 5 /* This program is free software; you can redistribute it and/or modify it */ 6 /* under the terms of the GNU General Public License as published by the */ 7 /* Free Software Foundation; either version 2 of the License, or (at your */ 8 /* option) any later version. */ 9 /* */ 10 /* This program is distributed in the hope that it will be useful, but WITHOUT */ 11 /* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or */ 12 /* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for */ 13 /* more details. */ 14 /* */ 15 /* You should have received a copy of the GNU General Public License along */ 16 /* with This program; see the file COPYING. If not,write to the Free Software */ 17 /* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ 18 /*******************************************************************************/ 19 20 #pragma once 21 22 #include <lo/lo.h> 23 24 namespace NSM 25 { 26 class Client 27 { 28 private: 29 30 const char *nsm_url; 31 32 lo_server _server; 33 lo_server_thread _st; 34 lo_address nsm_addr; 35 36 bool nsm_is_active; 37 char *nsm_client_id; 38 char *_session_manager_name; 39 40 public: 41 42 enum { 43 ERR_OK = 0, 44 ERR_GENERAL = -1, 45 ERR_INCOMPATIBLE_API = -2, 46 ERR_BLACKLISTED = -3, 47 ERR_LAUNCH_FAILED = -4, 48 ERR_NO_SUCH_FILE = -5, 49 ERR_NO_SESSION_OPEN = -6, 50 ERR_UNSAVED_CHANGES = -7, 51 ERR_NOT_NOW = -8 52 }; 53 54 Client(); 55 virtual ~Client(); 56 57 bool is_active(void) { return nsm_is_active; } 58 59 const char *session_manager_name(void) { 60 return 61 _session_manager_name; 62 } 63 64 /* Client->Server methods */ 65 void is_dirty(void); 66 void is_clean(void); 67 void progress(float f); 68 void message(int priority, const char *msg); 69 void announce(const char *appliction_name, 70 const char *capabilities, 71 const char *process_name); 72 73 void broadcast(lo_message msg); 74 75 /* init without threading */ 76 int init(const char *nsm_url); 77 /* init with threading */ 78 int init_thread(const char *nsm_url); 79 80 /* call this periodically to check for new messages */ 81 void check(int timeout = 0); 82 83 /* or call these to start and stop a thread (must do your own locking in handler!) */ 84 void start(void); 85 void stop(void); 86 87 protected: 88 89 /* Server->Client methods */ 90 virtual int command_open(const char *name, 91 const char *display_name, 92 const char *client_id, 93 char **out_msg) = 0; 94 virtual int command_save(char **out_msg) = 0; 95 96 virtual void command_active(bool) { } 97 98 virtual void command_session_is_loaded(void) { } 99 100 /* invoked when an unrecognized message is received. Should return 0 if you handled it, -1 otherwise. */ 101 virtual int command_broadcast(const char *, lo_message) { return -1; } 102 103 private: 104 105 /* osc handlers */ 106 static int osc_open(const char *path, 107 const char *types, 108 lo_arg **argv, 109 int argc, 110 lo_message msg, 111 void *user_data); 112 static int osc_save(const char *path, 113 const char *types, 114 lo_arg **argv, 115 int argc, 116 lo_message msg, 117 void *user_data); 118 static int osc_announce_reply(const char *path, 119 const char *types, 120 lo_arg **argv, 121 int argc, 122 lo_message msg, 123 void *user_data); 124 static int osc_error(const char *path, 125 const char *types, 126 lo_arg **argv, 127 int argc, 128 lo_message msg, 129 void *user_data); 130 static int osc_session_is_loaded(const char *path, 131 const char *types, 132 lo_arg **argv, 133 int argc, 134 lo_message msg, 135 void *user_data); 136 static int osc_broadcast(const char *path, 137 const char *types, 138 lo_arg **argv, 139 int argc, 140 lo_message msg, 141 void *user_data); 142 }; 143 };