2 * AT-SPI - Assistive Technology Service Provider Interface
3 * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
5 * Copyright 2001 Sun Microsystems Inc.
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.
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.
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.
26 #include <sys/socket.h>
28 #include "../util/mag_client.h"
29 #include "../cspi/spi-private.h" /* A hack for now */
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);
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);
43 static SPIBoolean use_magnifier = FALSE;
44 static SPIBoolean use_festival = FALSE;
45 static SPIBoolean festival_chatty = FALSE;
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;
55 main (int argc, char **argv)
62 Accessible *application;
65 if ((argc > 1) && (!strncmp (argv[1], "-h", 2)))
67 printf ("Usage: simple-at\n");
68 printf ("\tEnvironment variables used:\n\t\tFESTIVAL\n\t\tMAGNIFIER\n\t\tFESTIVAL_CHATTY\n");
72 modules = g_getenv ("GTK_MODULES");
73 if (!modules || modules [0] == '\0')
75 putenv ("GTK_MODULES=gail:atk-bridge");
81 focus_listener = SPI_createAccessibleEventListener (report_focus_event, NULL);
82 property_listener = SPI_createAccessibleEventListener (check_property_change, NULL);
83 generic_listener = SPI_createAccessibleEventListener (report_generic_event, NULL);
84 button_listener = SPI_createAccessibleEventListener (report_button_press, NULL);
85 SPI_registerGlobalEventListener (focus_listener, "focus:");
86 SPI_registerGlobalEventListener (property_listener, "object:property-change:accessible-selection");
87 SPI_registerGlobalEventListener (generic_listener, "object:selection-changed");
88 SPI_registerGlobalEventListener (generic_listener, "object:children-changed");
89 SPI_registerGlobalEventListener (generic_listener, "object:visible-data-changed");
90 SPI_registerGlobalEventListener (generic_listener, "object:text-selection-changed");
91 SPI_registerGlobalEventListener (generic_listener, "object:text-caret-moved");
92 SPI_registerGlobalEventListener (generic_listener, "object:text-changed");
93 SPI_registerGlobalEventListener (button_listener, "Gtk:GtkWidget:button-press-event");
94 n_desktops = SPI_getDesktopCount ();
96 for (i=0; i<n_desktops; ++i)
98 desktop = SPI_getDesktop (i);
99 s = Accessible_getName (desktop);
100 fprintf (stderr, "desktop %d name: %s\n", i, s);
102 n_apps = Accessible_getChildCount (desktop);
103 for (j=0; j<n_apps; ++j)
105 application = Accessible_getChildAtIndex (desktop, j);
106 s = Accessible_getName (application);
107 fprintf (stderr, "app %d name: %s\n", j, s);
109 Accessible_unref (application);
111 Accessible_unref (desktop);
114 /* prepare the keyboard snoopers */
115 command_key_listener = SPI_createAccessibleKeystrokeListener (report_command_key_event, NULL);
116 ordinary_key_listener = SPI_createAccessibleKeystrokeListener (report_ordinary_key_event, NULL);
118 /* will listen only to Control-Alt-key combinations, and only to KeyPress events */
119 SPI_registerAccessibleKeystrokeListener(command_key_listener,
120 (AccessibleKeySet *) SPI_KEYSET_ALL_KEYS,
121 SPI_KEYMASK_ALT | SPI_KEYMASK_CONTROL,
122 (unsigned long) ( SPI_KEY_PRESSED ),
123 SPI_KEYLISTENER_ALL_WINDOWS);
125 /* will listen only to CAPSLOCK-Alt-key combinations, and only to KeyPress events */
126 SPI_registerAccessibleKeystrokeListener(command_key_listener,
127 (AccessibleKeySet *) SPI_KEYSET_ALL_KEYS,
128 SPI_KEYMASK_ALT | SPI_KEYMASK_SHIFTLOCK,
129 (unsigned long) ( SPI_KEY_PRESSED ),
130 SPI_KEYLISTENER_ALL_WINDOWS);
132 /* will listen only to CAPSLOCK key events, both press and release */
133 SPI_registerAccessibleKeystrokeListener(ordinary_key_listener,
134 (AccessibleKeySet *) SPI_KEYSET_ALL_KEYS,
135 SPI_KEYMASK_SHIFTLOCK,
136 (unsigned long) ( SPI_KEY_PRESSED | SPI_KEY_RELEASED ),
137 SPI_KEYLISTENER_NOSYNC);
139 get_environment_vars ();
143 putenv ("AT_BRIDGE_SHUTDOWN=1");
149 get_environment_vars (void)
151 if (g_getenv ("FESTIVAL"))
153 fprintf (stderr, "Using festival\n");
155 if (g_getenv ("FESTIVAL_CHATTY"))
157 festival_chatty = TRUE;
160 if (g_getenv ("MAGNIFIER"))
162 fprintf (stderr, "Using magnifier\n");
163 use_magnifier = TRUE;
167 fprintf (stderr, "Not using magnifier\n");
172 fprintf (stderr, "No speech output\n");
177 report_focussed_accessible (Accessible *obj, SPIBoolean shutup_previous_speech)
186 s = Accessible_getRoleName (obj);
187 _festival_say (s, "voice_don_diphone", shutup_previous_speech);
190 fprintf (stderr, "getting Name\n");
191 s = Accessible_getName (obj);
192 _festival_say (s, "voice_kal_diphone",
193 shutup_previous_speech || festival_chatty);
197 if (Accessible_isComponent (obj))
199 long x, y, width, height;
200 AccessibleComponent *component = Accessible_getComponent (obj);
201 AccessibleComponent_getExtents (component, &x, &y, &width, &height,
202 SPI_COORD_TYPE_SCREEN);
203 fprintf (stderr, "Bounding box: (%ld, %ld) ; (%ld, %ld)\n",
204 x, y, x+width, y+height);
206 magnifier_set_roi ((short) 0, x, y, width, height);
210 if (Accessible_isValue (obj))
212 AccessibleValue *value = Accessible_getValue (obj);
213 fprintf (stderr, "Current value = %f, min = %f; max = %f\n",
214 AccessibleValue_getCurrentValue (value),
215 AccessibleValue_getMinimumValue (value),
216 AccessibleValue_getMaximumValue (value));
218 /* if this is a text object, speak the first sentence. */
220 if (Accessible_isText(obj))
223 AccessibleText *text_interface;
224 long start_offset, end_offset;
225 char *first_sentence = "empty";
226 text_interface = Accessible_getText (obj);
227 first_sentence = AccessibleText_getTextAtOffset (
228 text_interface, (long) 0, SPI_TEXT_BOUNDARY_SENTENCE_START, &start_offset, &end_offset);
231 _festival_say(first_sentence, "voice_don_diphone", FALSE);
232 SPI_freeString (first_sentence);
234 len = AccessibleText_getCharacterCount (text_interface);
235 s = AccessibleText_getText (text_interface, 0, len);
236 fprintf (stderr, "done reporting on focussed object, text=%s\n", s);
241 report_focus_event (AccessibleEvent *event, void *user_data)
245 g_return_if_fail (event->source != NULL);
247 s = Accessible_getName (event->source);
250 fprintf (stderr, "%s event from %s\n", event->type, s);
252 report_focussed_accessible (event->source, TRUE);
254 Accessible_getParent (event->source);
258 report_generic_event (AccessibleEvent *event, void *user_data)
260 fprintf (stderr, "%s event received\n", event->type);
264 report_button_press (AccessibleEvent *event, void *user_data)
268 g_return_if_fail (event->source != NULL);
270 s = Accessible_getName (event->source);
272 fprintf (stderr, "%s event from %s\n", event->type, s);
274 s = Accessible_getDescription (event->source);
275 fprintf (stderr, "Object description %s\n", s);
280 check_property_change (AccessibleEvent *event, void *user_data)
282 AccessibleSelection *selection = Accessible_getSelection (event->source);
288 n_selections = (int) AccessibleSelection_getNSelectedChildren (selection);
289 s = Accessible_getName (event->source);
290 fprintf (stderr, "(Property) %s event from %s, %d selected children\n",
291 event->type, s, n_selections);
293 /* for now, speak entire selection set */
294 for (i=0; i<n_selections; ++i)
296 Accessible *obj = AccessibleSelection_getSelectedChild (selection, (long) i);
297 g_return_if_fail (obj);
298 s = Accessible_getName (obj);
299 fprintf (stderr, "Child %d, name=%s\n", i, s);
301 report_focussed_accessible (obj, i==0);
309 SPI_deregisterGlobalEventListenerAll (focus_listener);
310 AccessibleEventListener_unref (focus_listener);
312 SPI_deregisterGlobalEventListenerAll (property_listener);
313 AccessibleEventListener_unref (property_listener);
315 SPI_deregisterGlobalEventListenerAll (generic_listener);
316 AccessibleEventListener_unref (generic_listener);
318 SPI_deregisterGlobalEventListenerAll (button_listener);
319 AccessibleEventListener_unref (button_listener);
321 SPI_deregisterAccessibleKeystrokeListener (command_key_listener, SPI_KEYMASK_ALT | SPI_KEYMASK_CONTROL);
322 SPI_deregisterAccessibleKeystrokeListener (command_key_listener, SPI_KEYMASK_ALT | SPI_KEYMASK_SHIFTLOCK);
323 AccessibleKeystrokeListener_unref (command_key_listener);
325 SPI_deregisterAccessibleKeystrokeListener (ordinary_key_listener, SPI_KEYMASK_UNMODIFIED);
326 SPI_deregisterAccessibleKeystrokeListener (ordinary_key_listener, SPI_KEYMASK_SHIFTLOCK);
327 AccessibleKeystrokeListener_unref (ordinary_key_listener);
333 is_command_key (AccessibleKeystroke *key)
340 return TRUE; /* not reached */
343 use_magnifier = ! use_magnifier;
344 fprintf (stderr, "%ssing magnifier\n", use_magnifier ? "U" : "Not u");
348 use_festival = ! use_festival;
349 fprintf (stderr, "%speech output\n", use_festival ? "S" : "No s");
357 report_command_key_event (AccessibleKeystroke *key, void *user_data)
359 fprintf (stderr, "Command KeyEvent %s%c (keycode %d); string=%s; time=%lx\n",
360 (key->modifiers & SPI_KEYMASK_ALT)?"Alt-":"",
361 ((key->modifiers & SPI_KEYMASK_SHIFT)^(key->modifiers & SPI_KEYMASK_SHIFTLOCK))?
362 (char) toupper((int) key->keyID) : (char) tolower((int) key->keyID),
365 (long int) key->timestamp);
366 return is_command_key (key);
371 report_ordinary_key_event (AccessibleKeystroke *key, void *user_data)
373 fprintf (stderr, "Received key event:\tsym %ld\n\tmods %x\n\tcode %d\n\tstring=\'%s\'\n\ttime %lx\n",
375 (unsigned int) key->modifiers,
378 (long int) key->timestamp);
386 struct sockaddr_in name;
389 name.sin_family = AF_INET;
390 name.sin_port = htons (1314);
391 name.sin_addr.s_addr = htonl(INADDR_ANY);
392 fd = socket (PF_INET, SOCK_STREAM, 0);
394 while (connect(fd, (struct sockaddr *) &name, sizeof (name)) < 0) {
401 _festival_write ("(audio_mode'async)\n", fd);
402 _festival_write ("(Parameter.set 'Duration_Model 'Tree_ZScore)\n", fd);
403 _festival_write ("(Parameter.set 'Duration_Stretch 0.75)\n", fd);
408 _festival_say (const char *text, const char *voice, SPIBoolean shutup)
414 static gchar voice_spec[32];
418 fd = _festival_init ();
421 fprintf (stderr, "saying text: %s\n", text);
423 quoted = g_malloc(64+strlen(text)*2);
425 sprintf (prefix, "(SayText \"");
427 strncpy(quoted, prefix, 10);
428 p = quoted+strlen(prefix);
430 if ( *text == '\\' || *text == '"' )
439 if (shutup) _festival_write ("(audio_mode'shutup)\n", fd);
440 if (voice && (strncmp (voice, (char *) (voice_spec+1), strlen(voice))))
442 snprintf (voice_spec, 32, "(%s)\n", voice);
443 _festival_write (voice_spec, fd);
444 _festival_write ("(Parameter.set 'Duration_Model 'Tree_ZScore)\n", fd);
445 _festival_write ("(Parameter.set 'Duration_Stretch 0.75)\n", fd);
448 _festival_write (quoted, fd);
454 _festival_write (const gchar *command_string, int fd)
456 fprintf(stderr, command_string);
461 write(fd, command_string, strlen(command_string));