test/simple-at.c

   1 /*
   2  * AT-SPI - Assistive Technology Service Provider Interface
   3  * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
   4  *
   5  * Copyright 2001 Sun Microsystems Inc.
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Library General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Library General Public
  18  * License along with this library; if not, write to the
  19  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  */
  22
  23 #include <stdlib.h>
  24 #include <ctype.h>
  25 #include <unistd.h>
  26 #include <sys/socket.h>
  27 #include <sys/un.h>
  28 #include "../util/mag_client.h"
  29 #include "../cspi/spi-private.h" /* A hack for now */
  30
  31 static void report_focus_event    (AccessibleEvent *event, void *user_data);
  32 static void report_generic_event  (AccessibleEvent *event, void *user_data);
  33 static void report_button_press   (AccessibleEvent *event, void *user_data);
  34 static void check_property_change (AccessibleEvent *event, void *user_data);
  35 static SPIBoolean report_command_key_event  (AccessibleKeystroke *stroke, void *user_data);
  36 static SPIBoolean report_ordinary_key_event (AccessibleKeystroke *stroke, void *user_data);
  37 static void get_environment_vars (void);
  38
  39 static int _festival_init ();
  40 static void _festival_say (const char *text, const char *voice, SPIBoolean shutup);
  41 static void _festival_write (const char *buff, int fd);
  42
  43 static SPIBoolean use_magnifier = FALSE;
  44 static SPIBoolean use_festival = FALSE;
  45 static SPIBoolean festival_chatty = FALSE;
  46
  47 static AccessibleEventListener *focus_listener;
  48 static AccessibleEventListener *property_listener;
  49 static AccessibleEventListener *generic_listener;
  50 static AccessibleEventListener *button_listener;
  51 static AccessibleKeystrokeListener *command_key_listener;
  52 static AccessibleKeystrokeListener *ordinary_key_listener;
  53 static AccessibleKeySet *spacebar_key_set;
  54
  55 int
  56 main (int argc, char **argv)
  57 {
  58   int i, j;
  59   int n_desktops;
  60   int n_apps;
  61   char *s;
  62   Accessible *desktop;
  63   Accessible *application;
  64   const char *modules;
  65
  66   if ((argc > 1) && (!strncmp (argv[1], "-h", 2)))
  67     {
  68       printf ("Usage: simple-at\n");
  69       printf ("\tEnvironment variables used:\n\t\tFESTIVAL\n\t\tMAGNIFIER\n\t\tFESTIVAL_CHATTY\n");
  70       exit (0);
  71     }
  72
  73   modules = g_getenv ("GTK_MODULES");
  74   if (!modules || modules [0] == '\0')
  75     {
  76       putenv ("GTK_MODULES=gail:at-bridge");
  77     }
  78   modules = NULL;
  79
  80   SPI_init ();
  81
  82   focus_listener = SPI_createAccessibleEventListener (report_focus_event, NULL);
  83   property_listener = SPI_createAccessibleEventListener (check_property_change, NULL);
  84   generic_listener = SPI_createAccessibleEventListener (report_generic_event, NULL);
  85   button_listener = SPI_createAccessibleEventListener (report_button_press, NULL);
  86   SPI_registerGlobalEventListener (focus_listener, "focus:");
  87   SPI_registerGlobalEventListener (property_listener, "object:property-change:accessible-selection");
  88   SPI_registerGlobalEventListener (generic_listener, "object:selection-changed");
  89   SPI_registerGlobalEventListener (generic_listener, "object:children-changed");
  90   SPI_registerGlobalEventListener (generic_listener, "object:visible-data-changed");
  91   SPI_registerGlobalEventListener (generic_listener, "object:text-selection-changed");
  92   SPI_registerGlobalEventListener (generic_listener, "object:text-caret-moved");
  93   SPI_registerGlobalEventListener (generic_listener, "object:text-changed");
  94   SPI_registerGlobalEventListener (button_listener, "Gtk:GtkWidget:button-press-event");
  95   n_desktops = SPI_getDesktopCount ();
  96
  97   for (i=0; i<n_desktops; ++i)
  98     {
  99       desktop = SPI_getDesktop (i);
 100       s = Accessible_getName (desktop);
 101       fprintf (stderr, "desktop %d name: %s\n", i, s);
 102       SPI_freeString (s);
 103       n_apps = Accessible_getChildCount (desktop);
 104       for (j=0; j<n_apps; ++j)
 105         {
 106           application = Accessible_getChildAtIndex (desktop, j);
 107           s = Accessible_getName (application);
 108           fprintf (stderr, "app %d name: %s\n", j, s);
 109           SPI_freeString (s);
 110           Accessible_unref (application);
 111         }
 112       Accessible_unref (desktop);
 113     }
 114
 115   /* prepare the keyboard snoopers */
 116   command_key_listener = SPI_createAccessibleKeystrokeListener (report_command_key_event, NULL);
 117   ordinary_key_listener = SPI_createAccessibleKeystrokeListener (report_ordinary_key_event, NULL);
 118
 119   /* will listen only to Control-Alt-key combinations, and only to KeyPress events */
 120   SPI_registerAccessibleKeystrokeListener(command_key_listener,
 121                                           (AccessibleKeySet *) SPI_KEYSET_ALL_KEYS,
 122                                           SPI_KEYMASK_ALT | SPI_KEYMASK_CONTROL,
 123                                           (unsigned long) ( SPI_KEY_PRESSED ),
 124                                           SPI_KEYLISTENER_ALL_WINDOWS);
 125
 126   /* will listen only to shifted key events, both press and release */
 127   SPI_registerAccessibleKeystrokeListener(ordinary_key_listener,
 128                                           (AccessibleKeySet *) SPI_KEYSET_ALL_KEYS,
 129                                           SPI_KEYMASK_SHIFT,
 130                                           (unsigned long) ( SPI_KEY_PRESSED | SPI_KEY_RELEASED ),
 131                                           SPI_KEYLISTENER_NOSYNC);
 132
 133   spacebar_key_set = SPI_createAccessibleKeySet (1, " ", NULL, NULL);
 134
 135   /* will listen only to shift-spacebar events, on release, globally */
 136   SPI_registerAccessibleKeystrokeListener(command_key_listener,
 137                                           spacebar_key_set,
 138                                           SPI_KEYMASK_SHIFT,
 139                                           (unsigned long) ( SPI_KEY_RELEASED ),
 140                                           SPI_KEYLISTENER_ALL_WINDOWS);
 141
 142
 143   get_environment_vars ();
 144
 145   SPI_event_main ();
 146
 147   putenv ("AT_BRIDGE_SHUTDOWN=1");
 148
 149   return SPI_exit ();
 150 }
 151
 152 static void
 153 get_environment_vars (void)
 154 {
 155   if (g_getenv ("FESTIVAL"))
 156     {
 157       fprintf (stderr, "Using festival\n");
 158       use_festival = TRUE;
 159       if (g_getenv ("FESTIVAL_CHATTY"))
 160         {
 161           festival_chatty = TRUE;
 162         }
 163     }
 164   if (g_getenv ("MAGNIFIER"))
 165     {
 166       fprintf (stderr, "Using magnifier\n");
 167       use_magnifier = TRUE;
 168     }
 169   else
 170     {
 171       fprintf (stderr, "Not using magnifier\n");
 172     }
 173
 174   if (!use_festival)
 175     {
 176       fprintf (stderr, "No speech output\n");
 177     }
 178 }
 179
 180 void
 181 report_focussed_accessible (Accessible *obj, SPIBoolean shutup_previous_speech)
 182 {
 183   char *s;
 184   int len;
 185
 186   if (use_festival)
 187     {
 188       if (festival_chatty)
 189         {
 190           s = Accessible_getRoleName (obj);
 191           _festival_say (s, "voice_don_diphone", shutup_previous_speech);
 192           SPI_freeString (s);
 193         }
 194       fprintf (stderr, "getting Name\n");
 195       s = Accessible_getName (obj);
 196       _festival_say (s, "voice_kal_diphone",
 197                      shutup_previous_speech || festival_chatty);
 198       SPI_freeString (s);
 199     }
 200
 201   if (Accessible_isComponent (obj))
 202     {
 203       long x, y, width, height;
 204       AccessibleComponent *component = Accessible_getComponent (obj);
 205       AccessibleComponent_getExtents (component, &x, &y, &width, &height,
 206                                       SPI_COORD_TYPE_SCREEN);
 207       fprintf (stderr, "Bounding box: (%ld, %ld) ; (%ld, %ld)\n",
 208                x, y, x+width, y+height);
 209       if (use_magnifier) {
 210               magnifier_set_roi ((short) 0, x, y, width, height);
 211       }
 212     }
 213
 214   if (Accessible_isValue (obj))
 215     {
 216       AccessibleValue *value = Accessible_getValue (obj);
 217       fprintf (stderr, "Current value = %f, min = %f; max = %f\n",
 218                AccessibleValue_getCurrentValue (value),
 219                AccessibleValue_getMinimumValue (value),
 220                AccessibleValue_getMaximumValue (value));
 221     }
 222   /* if this is a text object, speak the first sentence. */
 223
 224   if (Accessible_isText(obj))
 225
 226   {
 227      AccessibleText *text_interface;
 228      long start_offset, end_offset;
 229      char *first_sentence = "empty";
 230      text_interface = Accessible_getText (obj);
 231      first_sentence = AccessibleText_getTextAtOffset (
 232                text_interface, (long) 0, SPI_TEXT_BOUNDARY_SENTENCE_START, &start_offset, &end_offset);
 233      if (first_sentence)
 234        {
 235          _festival_say(first_sentence, "voice_don_diphone", FALSE);
 236          SPI_freeString (first_sentence);
 237        }
 238      len = AccessibleText_getCharacterCount (text_interface);
 239      s = AccessibleText_getText (text_interface, 0, len);
 240      fprintf (stderr, "done reporting on focussed object, text=%s\n", s);
 241   }
 242 }
 243
 244 void
 245 report_focus_event (AccessibleEvent *event, void *user_data)
 246 {
 247   char *s;
 248
 249   g_return_if_fail (event->source != NULL);
 250
 251   s = Accessible_getName (event->source);
 252   if (s)
 253     {
 254       fprintf (stderr, "%s event from %s\n", event->type, s);
 255       SPI_freeString (s);
 256       report_focussed_accessible (event->source, TRUE);
 257     }
 258   Accessible_getParent (event->source);
 259 }
 260
 261 void
 262 report_generic_event (AccessibleEvent *event, void *user_data)
 263 {
 264   fprintf (stderr, "%s event received\n", event->type);
 265 }
 266
 267 void
 268 report_button_press (AccessibleEvent *event, void *user_data)
 269 {
 270   char *s;
 271
 272   g_return_if_fail (event->source != NULL);
 273
 274   s = Accessible_getName (event->source);
 275
 276   fprintf (stderr, "%s event from %s\n", event->type, s);
 277   SPI_freeString (s);
 278   s = Accessible_getDescription (event->source);
 279   fprintf (stderr, "Object description %s\n", s);
 280   SPI_freeString (s);
 281 }
 282
 283 void
 284 check_property_change (AccessibleEvent *event, void *user_data)
 285 {
 286   AccessibleSelection *selection = Accessible_getSelection (event->source);
 287   int n_selections;
 288   int i;
 289   char *s;
 290   if (selection)
 291   {
 292     n_selections = (int) AccessibleSelection_getNSelectedChildren (selection);
 293     s = Accessible_getName (event->source);
 294     fprintf (stderr, "(Property) %s event from %s, %d selected children\n",
 295              event->type, s, n_selections);
 296     SPI_freeString (s);
 297   /* for now, speak entire selection set */
 298     for (i=0; i<n_selections; ++i)
 299       {
 300         Accessible *obj = AccessibleSelection_getSelectedChild (selection, (long) i);
 301         g_return_if_fail (obj);
 302         s = Accessible_getName (obj);
 303         fprintf (stderr, "Child %d, name=%s\n", i, s);
 304         SPI_freeString (s);
 305         report_focussed_accessible (obj, i==0);
 306     }
 307   }
 308 }
 309
 310 static void
 311 simple_at_exit ()
 312 {
 313   SPI_deregisterGlobalEventListenerAll (focus_listener);
 314   AccessibleEventListener_unref        (focus_listener);
 315
 316   SPI_deregisterGlobalEventListenerAll (property_listener);
 317   AccessibleEventListener_unref        (property_listener);
 318
 319   SPI_deregisterGlobalEventListenerAll (generic_listener);
 320   AccessibleEventListener_unref        (generic_listener);
 321
 322   SPI_deregisterGlobalEventListenerAll (button_listener);
 323   AccessibleEventListener_unref        (button_listener);
 324
 325   SPI_deregisterAccessibleKeystrokeListener (command_key_listener, SPI_KEYMASK_ALT);
 326   AccessibleKeystrokeListener_unref         (command_key_listener);
 327
 328   SPI_deregisterAccessibleKeystrokeListener (ordinary_key_listener, SPI_KEYMASK_UNMODIFIED);
 329   SPI_deregisterAccessibleKeystrokeListener (ordinary_key_listener, SPI_KEYMASK_SHIFT);
 330   AccessibleKeystrokeListener_unref         (ordinary_key_listener);
 331
 332   SPI_freeAccessibleKeySet (spacebar_key_set);
 333
 334   SPI_event_quit ();
 335 }
 336
 337 static SPIBoolean
 338 is_command_key (AccessibleKeystroke *key)
 339 {
 340   switch (key->keyID)
 341     {
 342     case 'Q':
 343     case 'q':
 344             simple_at_exit();
 345             return TRUE; /* not reached */
 346     case 'M':
 347     case 'm':
 348             use_magnifier = ! use_magnifier;
 349             fprintf (stderr, "%ssing magnifier\n", use_magnifier ? "U" : "Not u");
 350             return TRUE;
 351     case 'F':
 352     case 'f':
 353             use_festival = ! use_festival;
 354             fprintf (stderr, "%speech output\n", use_festival ? "S" : "No s");
 355             return TRUE;
 356     default:
 357             return FALSE;
 358     }
 359 }
 360
 361 static SPIBoolean
 362 report_command_key_event (AccessibleKeystroke *key, void *user_data)
 363 {
 364   fprintf (stderr, "Command KeyEvent %s%c (keycode %d); string=%s; time=%lx\n",
 365           (key->modifiers & SPI_KEYMASK_ALT)?"Alt-":"",
 366           ((key->modifiers & SPI_KEYMASK_SHIFT)^(key->modifiers & SPI_KEYMASK_SHIFTLOCK))?
 367           (char) toupper((int) key->keyID) : (char) tolower((int) key->keyID),
 368           (int) key->keycode,
 369           key->keystring,
 370           (long int) key->timestamp);
 371   return is_command_key (key);
 372 }
 373
 374
 375 static SPIBoolean
 376 report_ordinary_key_event (AccessibleKeystroke *key, void *user_data)
 377 {
 378   fprintf (stderr, "Received key event:\tsym %ld\n\tmods %x\n\tcode %d\n\tstring=\'%s\'\n\ttime %lx\n",
 379            (long) key->keyID,
 380            (unsigned int) key->modifiers,
 381            (int) key->keycode,
 382            key->keystring,
 383            (long int) key->timestamp);
 384   return FALSE;
 385 }
 386
 387 static int
 388 _festival_init ()
 389 {
 390   int fd;
 391   struct sockaddr_in name;
 392   int tries = 2;
 393
 394   name.sin_family = AF_INET;
 395   name.sin_port = htons (1314);
 396   name.sin_addr.s_addr = htonl(INADDR_ANY);
 397   fd = socket (PF_INET, SOCK_STREAM, 0);
 398
 399   while (connect(fd, (struct sockaddr *) &name, sizeof (name)) < 0) {
 400     if (!tries--) {
 401       perror ("connect");
 402       return -1;
 403     }
 404   }
 405
 406   _festival_write ("(audio_mode'async)\n", fd);
 407   _festival_write ("(Parameter.set 'Duration_Model 'Tree_ZScore)\n", fd);
 408   _festival_write ("(Parameter.set 'Duration_Stretch 0.75)\n", fd);
 409   return fd;
 410 }
 411
 412 static void
 413 _festival_say (const char *text, const char *voice, SPIBoolean shutup)
 414 {
 415   static int fd = 0;
 416   gchar *quoted;
 417   gchar *p;
 418   gchar prefix[50];
 419   static gchar voice_spec[32];
 420
 421   if (!fd)
 422     {
 423       fd = _festival_init ();
 424     }
 425
 426   fprintf (stderr, "saying text: %s\n", text);
 427
 428   quoted = g_malloc(64+strlen(text)*2);
 429
 430   sprintf (prefix, "(SayText \"");
 431
 432   strncpy(quoted, prefix, 10);
 433   p = quoted+strlen(prefix);
 434   while (*text) {
 435     if ( *text == '\\' || *text == '"' )
 436       *p = '\\';
 437     *p++ = *text++;
 438   }
 439   *p++ = '"';
 440   *p++ = ')';
 441   *p++ = '\n';
 442   *p = 0;
 443
 444   if (shutup) _festival_write ("(audio_mode'shutup)\n", fd);
 445   if (voice && (strncmp (voice, (char *) (voice_spec+1), strlen(voice))))
 446     {
 447       snprintf (voice_spec, 32, "(%s)\n", voice);
 448       _festival_write (voice_spec, fd);
 449       _festival_write ("(Parameter.set 'Duration_Model 'Tree_ZScore)\n", fd);
 450       _festival_write ("(Parameter.set 'Duration_Stretch 0.75)\n", fd);
 451     }
 452
 453   _festival_write (quoted, fd);
 454
 455   g_free(quoted);
 456 }
 457
 458 static void
 459 _festival_write (const gchar *command_string, int fd)
 460 {
 461   fprintf(stderr, command_string);
 462   if (fd < 0) {
 463     perror("socket");
 464     return;
 465   }
 466   write(fd, command_string, strlen(command_string));
 467 }
 468