gui/canvas.h

   1 /* -*- Mode: C ; c-basic-offset: 2 -*- */
   2 /*
   3  * LADI Session Handler (ladish)
   4  *
   5  * Copyright (C) 2009 Nedko Arnaudov <nedko@arnaudov.name>
   6  *
   7  **************************************************************************
   8  * This file contains the interface to the canvas functionality
   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 CANVAS_H__BE110B39_CB54_47C2_A5B2_FFB3BA7CDA6D__INCLUDED
  28 #define CANVAS_H__BE110B39_CB54_47C2_A5B2_FFB3BA7CDA6D__INCLUDED
  29
  30 #include "common.h"
  31
  32 typedef struct canvas_tag { int unused; } * canvas_handle;
  33 typedef struct canvas_module_tag { int unused; } * canvas_module_handle;
  34 typedef struct canvas_port_tag { int unused; } * canvas_port_handle;
  35
  36 #ifdef __cplusplus
  37 extern "C" {
  38 #endif
  39 #if 0
  40 } /* Adjust editor indent */
  41 #endif
  42
  43 bool
  44 canvas_init(
  45   void);
  46
  47 bool
  48 canvas_create(
  49   double width,
  50   double height,
  51   void (* connect_request)(void * port1_context, void * port2_context),
  52   void (* disconnect_request)(void * port1_context, void * port2_context),
  53   void (* module_location_changed)(void * module_context, double x, double y),
  54   canvas_handle * canvas_handle_ptr);
  55
  56 GtkWidget *
  57 canvas_get_widget(
  58   canvas_handle canvas);
  59
  60 void
  61 canvas_destroy(
  62   canvas_handle canvas);
  63
  64 void
  65 canvas_clear(
  66   canvas_handle canvas);
  67
  68 void
  69 canvas_get_size(
  70   canvas_handle canvas,
  71   double * width_ptr,
  72   double * height_ptr);
  73
  74 void
  75 canvas_scroll_to_center(
  76   canvas_handle canvas);
  77
  78 void
  79 canvas_set_zoom(
  80   canvas_handle canvas,
  81   double pix_per_unit);
  82
  83 void
  84 canvas_arrange(
  85   canvas_handle canvas);
  86
  87 bool
  88 canvas_create_module(
  89   canvas_handle canvas,
  90   const char * name,
  91   double x,
  92   double y,
  93   bool show_title,
  94   bool show_port_labels,
  95   void * module_context,
  96   canvas_module_handle * module_handle_ptr);
  97
  98 bool
  99 canvas_destroy_module(
 100   canvas_handle canvas,
 101   canvas_module_handle module);
 102
 103 void
 104 canvas_set_module_name(
 105   canvas_module_handle module,
 106   const char * name);
 107
 108 bool
 109 canvas_create_port(
 110   canvas_handle canvas,
 111   canvas_module_handle module,
 112   const char * name,
 113   bool is_input,
 114   int color,
 115   void * port_context,
 116   canvas_port_handle * port_handle_ptr);
 117
 118 bool
 119 canvas_destroy_port(
 120   canvas_handle canvas,
 121   canvas_port_handle port);
 122
 123 int
 124 canvas_get_port_color(
 125   canvas_port_handle port);
 126
 127 void
 128 canvas_set_port_name(
 129   canvas_port_handle port,
 130   const char * name);
 131
 132 bool
 133 canvas_add_connection(
 134   canvas_handle canvas,
 135   canvas_port_handle port1,
 136   canvas_port_handle port2,
 137   uint32_t color);
 138
 139 bool
 140 canvas_remove_connection(
 141   canvas_handle canvas,
 142   canvas_port_handle port1,
 143   canvas_port_handle port2);
 144
 145 bool
 146 canvas_enum_modules(
 147   canvas_handle canvas,
 148   void * callback_context,
 149   bool (* callback)(void * context, canvas_module_handle module));
 150
 151 bool
 152 canvas_enum_module_ports(
 153   canvas_handle canvas,
 154   canvas_module_handle module,
 155   void * callback_context,
 156   bool (* callback)(void * context, canvas_port_handle port));
 157
 158 #if 0
 159 { /* Adjust editor indent */
 160 #endif
 161 #ifdef __cplusplus
 162 } /* extern "C" */
 163 #endif
 164
 165 #endif /* #ifndef CANVAS_H__BE110B39_CB54_47C2_A5B2_FFB3BA7CDA6D__INCLUDED */