proxies/graph_proxy.h

   1 /* -*- Mode: C ; c-basic-offset: 2 -*- */
   2 /*
   3  * LADI Session Handler (ladish)
   4  *
   5  * Copyright (C) 2009,2010,2011 Nedko Arnaudov <nedko@arnaudov.name>
   6  *
   7  **************************************************************************
   8  * This file contains interface to graph object that is backed through D-Bus
   9  **************************************************************************
  10  *
  11  * LADI Session Handler is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * LADI Session Handler is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with LADI Session Handler. If not, see <http://www.gnu.org/licenses/>
  23  * or write to the Free Software Foundation, Inc.,
  24  * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  25  */
  26
  27 #ifndef GRAPH_PROXY_H__61D1ED56_E33B_4F50_B45B_F520979E8AA7__INCLUDED
  28 #define GRAPH_PROXY_H__61D1ED56_E33B_4F50_B45B_F520979E8AA7__INCLUDED
  29
  30 #include "common.h"
  31 #include <unistd.h>
  32
  33 typedef struct graph_proxy_tag { int unused; } * graph_proxy_handle;
  34
  35 #ifdef __cplusplus
  36 extern "C" {
  37 #endif
  38 #if 0
  39 } /* Adjust editor indent */
  40 #endif
  41
  42 bool
  43 graph_proxy_create(
  44   const char * service,
  45   const char * object,
  46   bool graph_dict_supported,
  47   bool graph_manager_supported,
  48   graph_proxy_handle * graph_proxy_ptr);
  49
  50 void
  51 graph_proxy_destroy(
  52   graph_proxy_handle graph);
  53
  54 const char * graph_proxy_get_service(graph_proxy_handle graph);
  55 const char * graph_proxy_get_object(graph_proxy_handle graph);
  56
  57 bool
  58 graph_proxy_activate(
  59   graph_proxy_handle graph);
  60
  61 bool
  62 graph_proxy_attach(
  63   graph_proxy_handle graph,
  64   void * context,
  65   void (* clear)(void * context),
  66   void (* client_appeared)(void * context, uint64_t id, const char * name),
  67   void (* client_renamed)(void * context, uint64_t client_id, const char * old_client_name, const char * new_client_name),
  68   void (* client_disappeared)(void * context, uint64_t id),
  69   void (* port_appeared)(void * context, uint64_t client_id, uint64_t port_id, const char * port_name, bool is_input, bool is_terminal, bool is_midi),
  70   void (* port_renamed)(void * context, uint64_t client_id, uint64_t port_id, const char * old_port_name, const char * new_port_name),
  71   void (* port_disappeared)(void * context, uint64_t client_id, uint64_t port_id),
  72   void (* ports_connected)(void * context, uint64_t client1_id, uint64_t port1_id, uint64_t client2_id, uint64_t port2_id),
  73   void (* ports_disconnected)(void * context, uint64_t client1_id, uint64_t port1_id, uint64_t client2_id, uint64_t port2_id));
  74
  75 void
  76 graph_proxy_detach(
  77   graph_proxy_handle graph,
  78   void * context);
  79
  80 bool
  81 graph_proxy_connect_ports(
  82   graph_proxy_handle graph,
  83   uint64_t port1_id,
  84   uint64_t port2_id);
  85
  86 bool
  87 graph_proxy_disconnect_ports(
  88   graph_proxy_handle graph,
  89   uint64_t port1_id,
  90   uint64_t port2_id);
  91
  92 bool
  93 graph_proxy_dict_entry_set(
  94   graph_proxy_handle graph,
  95   uint32_t object_type,
  96   uint64_t object_id,
  97   const char * key,
  98   const char * value);
  99
 100 bool
 101 graph_proxy_dict_entry_get(
 102   graph_proxy_handle graph,
 103   uint32_t object_type,
 104   uint64_t object_id,
 105   const char * key,
 106   char ** value);
 107
 108 bool
 109 graph_proxy_dict_entry_drop(
 110   graph_proxy_handle graph,
 111   uint32_t object_type,
 112   uint64_t object_id,
 113   const char * key);
 114
 115 bool graph_proxy_get_client_pid(graph_proxy_handle graph, uint64_t client_id, pid_t * pid_ptr);
 116
 117 bool
 118 graph_proxy_split(
 119   graph_proxy_handle graph,
 120   uint64_t client_id);
 121
 122 bool
 123 graph_proxy_join(
 124   graph_proxy_handle graph,
 125   uint64_t client1_id,
 126   uint64_t client2_id);
 127
 128 bool
 129 graph_proxy_rename_client(
 130   graph_proxy_handle graph,
 131   uint64_t client_id,
 132   const char * newname);
 133
 134 bool
 135 graph_proxy_rename_port(
 136   graph_proxy_handle graph,
 137   uint64_t port_id,
 138   const char * newname);
 139
 140 bool
 141 graph_proxy_move_port(
 142   graph_proxy_handle graph,
 143   uint64_t port_id,
 144   uint64_t client_id);
 145
 146 bool
 147 graph_proxy_new_client(
 148   graph_proxy_handle graph,
 149   const char * name,
 150   uint64_t * client_id_ptr);
 151
 152 bool
 153 graph_proxy_remove_client(
 154   graph_proxy_handle graph,
 155   uint64_t client_id);
 156
 157 #if 0
 158 { /* Adjust editor indent */
 159 #endif
 160 #ifdef __cplusplus
 161 } /* extern "C" */
 162 #endif
 163
 164 #endif /* #ifndef GRAPH_PROXY_H__61D1ED56_E33B_4F50_B45B_F520979E8AA7__INCLUDED */