1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453
|
/* praat_menuCommands.cpp
*
* Copyright (C) 1992-2011 Paul Boersma
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or (at
* your option) any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include "praatP.h"
#include "praat_script.h"
#define praat_MAXNUM_FIXED_COMMANDS 1000
static long theNumberOfCommands = 0;
static struct structPraat_Command *theCommands;
void praat_menuCommands_init (void) {
theCommands = Melder_calloc_f (struct structPraat_Command, praat_MAXNUM_FIXED_COMMANDS + 1);
}
static int compareMenuCommands (const void *void_me, const void *void_thee) {
praat_Command me = (praat_Command) void_me, thee = (praat_Command) void_thee;
int compare;
if (my window) {
if (! thy window) return 1;
compare = wcscmp (my window, thy window);
if (compare) return compare;
} else if (thy window) return -1;
if (my menu) {
if (! thy menu) return 1;
compare = wcscmp (my menu, thy menu);
if (compare) return compare;
} else if (thy menu) return -1;
if (my sortingTail < thy sortingTail) return -1;
return 1;
}
void praat_sortMenuCommands (void) {
for (long i = 1; i <= theNumberOfCommands; i ++)
theCommands [i]. sortingTail = i;
qsort (& theCommands [1], theNumberOfCommands, sizeof (struct structPraat_Command), compareMenuCommands);
}
static long lookUpMatchingMenuCommand (const wchar *window, const wchar *menu, const wchar *title) {
/*
* A menu command is fully specified by its environment (window + menu) and its title.
*/
for (long i = 1; i <= theNumberOfCommands; i ++) {
const wchar *tryWindow = theCommands [i]. window;
const wchar *tryMenu = theCommands [i]. menu;
const wchar *tryTitle = theCommands [i]. title;
if ((window == tryWindow || (window && tryWindow && wcsequ (window, tryWindow))) &&
(menu == tryMenu || (menu && tryMenu && wcsequ (menu, tryMenu))) &&
(title == tryTitle || (title && tryTitle && wcsequ (title, tryTitle)))) return i;
}
return 0; // not found
}
static void do_menu (I, unsigned long modified) {
void (*callback) (UiForm, const wchar *, Interpreter, const wchar *, bool, void *) = (void (*) (UiForm, const wchar *, Interpreter, const wchar *, bool, void *)) void_me;
Melder_assert (callback != NULL);
for (long i = 1; i <= theNumberOfCommands; i ++) {
praat_Command me = & theCommands [i];
if (my callback == callback) {
if (my title != NULL && ! wcsstr (my title, L"...")) {
UiHistory_write (L"\n");
UiHistory_write (my title);
}
try {
callback (NULL, NULL, NULL, my title, modified, NULL); therror
} catch (MelderError) {
Melder_error_ ("Command \"", my title, "\" not executed.");
Melder_flushError (NULL);
}
praat_updateSelection (); return;
}
if (my callback == DO_RunTheScriptFromAnyAddedMenuCommand && my script == (void *) void_me) {
if (my title != NULL && ! wcsstr (my title, L"...")) {
UiHistory_write (L"\nexecute ");
UiHistory_write (my script);
} else {
UiHistory_write (L"\nexecute \"");
UiHistory_write (my script);
UiHistory_write (L"\"");
}
try {
DO_RunTheScriptFromAnyAddedMenuCommand (NULL, my script, NULL, NULL, false, NULL); therror
} catch (MelderError) {
Melder_error_ ("Command \"", my title, "\" not executed.");
Melder_flushError (NULL);
}
praat_updateSelection (); return;
}
}
}
static void gui_button_cb_menu (I, GuiButtonEvent event) {
do_menu (void_me, event -> shiftKeyPressed | event -> commandKeyPressed | event -> optionKeyPressed | event -> extraControlKeyPressed);
}
static void gui_cb_menu (GUI_ARGS) {
/*
* Convert a Motif callback into a Ui callback, and catch modifier keys and special mouse buttons.
* Call that callback!
* Catch the error queue for menu commands without dots (...).
*/
(void) w;
#if defined (macintosh)
EventRecord *event = (EventRecord *) call;
enum { cmdKey = 256, shiftKey = 512, optionKey = 2048, controlKey = 4096 };
int modified = event -> what == mouseDown &&
(event -> modifiers & (cmdKey | shiftKey | optionKey | controlKey)) != 0;
#elif defined (_WIN32)
int modified = FALSE;
#else
#if gtk
// TODO: We kunnen bij GDK events geregistreren om key en button press af te vangen, maar dan
// wordt dit geen gewoon 'activate' signaal meer.
int modified = 0;
// TODO: Dit implementeert het gedrag van Motif, en impliceert dat een toggled Call alleen een
// 'naar positief' is en niet de terug toggle 'naar negatief'.
if (G_OBJECT_TYPE(w) == GTK_TYPE_RADIO_MENU_ITEM && !gtk_check_menu_item_get_active(GTK_CHECK_MENU_ITEM(w))) {
//g_debug("Gotcha!");
return;
}
#elif motif
XButtonPressedEvent *event = (XButtonPressedEvent *) ((XmDrawingAreaCallbackStruct *) call) -> event;
int modified = event -> type == ButtonPress &&
((event -> state & (ShiftMask | ControlMask | Mod1Mask)) != 0 || event -> button == Button2 || event -> button == Button3);
#endif
#endif
do_menu (void_me, modified);
}
static GuiObject windowMenuToWidget (const wchar *window, const wchar *menu) {
return
wcsequ (window, L"Picture") ? praat_picture_resolveMenu (menu) :
wcsequ (window, L"Objects") ? praat_objects_resolveMenu (menu) : NULL;
}
GuiObject praat_addMenuCommand (const wchar *window, const wchar *menu, const wchar *title,
const wchar *after, unsigned long flags, void (*callback) (UiForm, const wchar *, Interpreter, const wchar *, bool, void *))
{
long position;
int depth = flags, unhidable = FALSE, hidden = FALSE, key = 0;
unsigned long motifFlags = 0;
if (flags > 7) {
depth = ((flags & praat_DEPTH_7) >> 16);
unhidable = (flags & praat_UNHIDABLE) != 0;
hidden = (flags & praat_HIDDEN) != 0 && ! unhidable;
key = flags & 0x000000FF;
motifFlags = key ? flags & (0x006000FF | GuiMenu_BUTTON_STATE_MASK) : flags & GuiMenu_BUTTON_STATE_MASK;
}
if (callback && ! title) {
Melder_error_ ("praat_addMenuCommand: command with callback has no title. Window \"", window, "\", menu \"", menu, "\".");
Melder_flushError (NULL);
return NULL;
}
/* Determine the position of the new command.
*/
if (after) { /* Search for existing command with same selection. */
long found = lookUpMatchingMenuCommand (window, menu, after);
if (found) {
position = found + 1; /* After 'after'. */
} else {
Melder_error_ ("praat_addMenuCommand: the command \"", title, "\" cannot be put after \"", after, "\",\n"
"in the menu \"", menu, "\" in the window \"", window, "\"\n"
"because the latter command does not exist.");
Melder_flushError (NULL);
return NULL;
}
} else {
position = theNumberOfCommands + 1; /* At end. */
}
/* Increment the command area.
*/
if (theNumberOfCommands >= praat_MAXNUM_FIXED_COMMANDS) {
Melder_flushError ("praat_addMenuCommand: too many menu commands.");
return NULL;
}
theNumberOfCommands += 1;
/* Make room for insertion.
*/
for (long i = theNumberOfCommands; i > position; i --) theCommands [i] = theCommands [i - 1];
memset (& theCommands [position], 0, sizeof (struct structPraat_Command));
/* Insert new command.
*/
theCommands [position]. window = Melder_wcsdup_f (window);
theCommands [position]. menu = Melder_wcsdup_f (menu);
theCommands [position]. title = Melder_wcsdup_f (title);
theCommands [position]. depth = depth;
theCommands [position]. callback = callback; /* NULL for a separator or cascade button. */
theCommands [position]. executable = callback != NULL;
theCommands [position]. script = NULL;
theCommands [position]. hidden = hidden;
theCommands [position]. unhidable = unhidable;
if (! theCurrentPraatApplication -> batch) {
GuiObject parent = NULL;
/* WHERE TO PUT IT?
* Determine parent menu widget.
* This is not going to fail:
* if 'depth' is inappropriate, the alleged subitem will be put in the top menu.
*/
if (depth == 0) {
parent = windowMenuToWidget (window, menu); /* Not a subitem: in the top menu. */
} else {
for (long i = position - 1; i > 0; i --) {
if (theCommands [i]. depth == depth - 1) {
if (theCommands [i]. callback == NULL && theCommands [i]. title != NULL && theCommands [i]. title [0] != '-') /* Cascade button? */
#if gtk
parent = gtk_menu_item_get_submenu (GTK_MENU_ITEM (theCommands [i]. button));
#elif motif
XtVaGetValues (theCommands [i]. button, XmNsubMenuId, & parent, NULL); /* The relevant menu title. */
#endif
break;
}
}
if (! parent) parent = windowMenuToWidget (window, menu); /* Fallback: a subitem without a menu title. */
}
if (! parent) return NULL;
/* WHAT TO PUT THERE?
*/
if (title == NULL || title [0] == '-') {
theCommands [position]. button = GuiMenu_addSeparator (parent);
} else if (callback == NULL) {
(void) GuiMenuBar_addMenu2 (parent, title, 0, & theCommands [position]. button); /* Cascade button with submenu. */
} else {
theCommands [position]. button = GuiMenu_addItem (parent, title, motifFlags, gui_cb_menu, (void *) callback);
}
if (hidden) GuiObject_hide (theCommands [position]. button);
}
return theCommands [position]. button;
}
void praat_addMenuCommandScript (const wchar *window, const wchar *menu, const wchar *title,
const wchar *after, int depth, const wchar *script)
{
try {
Melder_assert (window && menu && title && after && script);
if (wcslen (script) && ! wcslen (title))
Melder_throw ("Command with script has no title. Window \"", window, "\", menu \"", menu, "\".");
/*
* Determine the position of the new command.
*/
long position;
if (wcslen (after)) { /* Search for existing command with same selection. */
long found = lookUpMatchingMenuCommand (window, menu, after);
if (found) {
position = found + 1; /* After 'after'. */
} else {
/*Melder_throw ("The menu command \"", title, "\" cannot be put after \"", after, "\",\n"
"in the menu \"", menu, "\" in the window \"", window, "\"\n"
"because the latter command does not exist.", title, after, menu, window);*/
position = theNumberOfCommands + 1; // default: at end
}
} else {
position = theNumberOfCommands + 1; /* At end. */
}
/*
* Increment the command area.
*/
if (theNumberOfCommands >= praat_MAXNUM_FIXED_COMMANDS)
Melder_throw ("Too many menu commands (maximum ", praat_MAXNUM_FIXED_COMMANDS, ").");
theNumberOfCommands += 1;
/*
* Make room for insertion.
*/
for (long i = theNumberOfCommands; i > position; i --) theCommands [i] = theCommands [i - 1];
memset (& theCommands [position], 0, sizeof (struct structPraat_Command));
/*
* Insert new command.
*/
theCommands [position]. window = Melder_wcsdup_f (window);
theCommands [position]. menu = Melder_wcsdup_f (menu);
theCommands [position]. title = wcslen (title) ? Melder_wcsdup_f (title) : NULL; /* Allow old-fashioned untitled separators. */
theCommands [position]. depth = depth;
theCommands [position]. callback = wcslen (script) ? DO_RunTheScriptFromAnyAddedMenuCommand : NULL; /* NULL for a separator or cascade button. */
theCommands [position]. executable = wcslen (script) != 0;
if (wcslen (script) == 0) {
theCommands [position]. script = Melder_wcsdup_f (L""); /* Empty string, which will be needed to signal origin. */
} else {
structMelderFile file = { 0 };
Melder_relativePathToFile (script, & file);
theCommands [position]. script = Melder_wcsdup_f (Melder_fileToPath (& file));
}
theCommands [position]. after = wcslen (after) ? Melder_wcsdup_f (after) : NULL;
if (praatP.phase >= praat_READING_BUTTONS) {
static long uniqueID = 0;
theCommands [position]. uniqueID = ++ uniqueID;
}
if (! theCurrentPraatApplication -> batch) {
GuiObject parent = NULL;
/* WHERE TO PUT IT?
* Determine parent menu widget.
* This is not going to fail:
* if 'depth' is inappropriate, the alleged subitem will be put in the top menu.
*/
if (depth == 0) {
parent = windowMenuToWidget (window, menu); /* Not a subitem: in the top menu. */
} else {
for (long i = position - 1; i > 0; i --) {
if (theCommands [i]. depth == depth - 1) {
if (theCommands [i]. callback == NULL && theCommands [i]. title != NULL && theCommands [i]. title [0] != '-') /* Cascade button? */
#if gtk
parent = gtk_menu_item_get_submenu (GTK_MENU_ITEM (theCommands [i]. button));
#elif motif
XtVaGetValues (theCommands [i]. button, XmNsubMenuId, & parent, NULL); /* The relevant menu title. */
#endif
break;
}
}
if (! parent) parent = windowMenuToWidget (window, menu); /* Fallback: a subitem without a menu title. */
}
if (parent) {
/* WHAT TO PUT THERE?
*/
if (title [0] == '\0' || title [0] == '-') {
theCommands [position]. button = GuiMenu_addSeparator (parent);
} else if (script [0] == '\0') {
(void) GuiMenuBar_addMenu2 (parent, title, 0, & theCommands [position]. button);
} else {
theCommands [position]. button = GuiMenu_addItem (parent, title, 0, gui_cb_menu, (void *) theCommands [position]. script); /* Not just "script"!! */
}
}
}
if (praatP.phase >= praat_HANDLING_EVENTS) praat_sortMenuCommands ();
} catch (MelderError) {
Melder_throw ("Script menu command not added.");
}
}
void praat_hideMenuCommand (const wchar *window, const wchar *menu, const wchar *title) {
if (theCurrentPraatApplication -> batch || ! window || ! menu || ! title) return;
long found = lookUpMatchingMenuCommand (window, menu, title);
if (! found) return;
praat_Command command = & theCommands [found];
if (! command -> hidden && ! command -> unhidable) {
command -> hidden = TRUE;
if (praatP.phase >= praat_READING_BUTTONS) command -> toggled = ! command -> toggled;
if (command -> button) GuiObject_hide (command -> button);
}
}
void praat_showMenuCommand (const wchar *window, const wchar *menu, const wchar *title) {
if (theCurrentPraatApplication -> batch || ! window || ! menu || ! title) return;
long found = lookUpMatchingMenuCommand (window, menu, title);
if (! found) return;
praat_Command command = & theCommands [found];
if (command -> hidden) {
command -> hidden = FALSE;
if (praatP.phase >= praat_READING_BUTTONS) command -> toggled = ! command -> toggled;
if (command -> button) GuiObject_show (command -> button);
}
}
void praat_saveMenuCommands (FILE *f) {
long maxID = 0;
for (long i = 1; i <= theNumberOfCommands; i ++) if (theCommands [i]. uniqueID > maxID) maxID = theCommands [i]. uniqueID;
for (long id = 1; id <= maxID; id ++) /* Sorted. */
for (long i = 1; i <= theNumberOfCommands; i ++) {
praat_Command me = & theCommands [i];
if (my uniqueID == id && ! my hidden && my window && my menu && my title) {
fwprintf (f, L"Add menu command... \"%ls\" \"%ls\" \"%ls\" \"%ls\" %d %ls\n",
my window, my menu, my title, my after ? my after : L"", my depth, my script ? my script : L"");
break;
}
}
for (long i = 1; i <= theNumberOfCommands; i ++) {
praat_Command me = & theCommands [i];
if (my toggled && my window && my menu && my title && ! my uniqueID && ! my script)
fwprintf (f, L"%ls menu command... \"%ls\" \"%ls\" %ls\n",
my hidden ? L"Hide" : L"Show", my window, my menu, my title);
}
}
/***** FIXED BUTTONS *****/
void praat_addFixedButtonCommand (GuiObject parent, const wchar *title, void (*callback) (UiForm, const wchar *, Interpreter, const wchar *, bool, void *), int x, int y) {
praat_Command me = & theCommands [++ theNumberOfCommands];
my window = Melder_wcsdup_f (L"Objects");
my title = title;
my callback = callback;
my unhidable = TRUE;
if (theCurrentPraatApplication -> batch) {
my button = NULL;
} else {
GuiObject button = my button = GuiButton_create (parent, x, x + 82, Gui_AUTOMATIC, -y,
title, gui_button_cb_menu, (void *) callback, 0); // BUG: shouldn't convert a function pointer to a void pointer
GuiObject_setSensitive (button, false);
GuiObject_show (button);
}
my executable = False;
}
void praat_sensitivizeFixedButtonCommand (const wchar *title, int sensitive) {
long i = 1;
for (; i <= theNumberOfCommands; i ++)
if (wcsequ (theCommands [i]. title, title)) break; // search
theCommands [i]. executable = sensitive;
if (! theCurrentPraatApplication -> batch && ! Melder_backgrounding) GuiObject_setSensitive (theCommands [i]. button, sensitive);
}
int praat_doMenuCommand (const wchar *command, const wchar *arguments, Interpreter interpreter) {
long i = 1;
while (i <= theNumberOfCommands && (! theCommands [i]. executable || ! wcsequ (theCommands [i]. title, command) ||
(! wcsequ (theCommands [i]. window, L"Objects") && ! wcsequ (theCommands [i]. window, L"Picture")))) i ++;
if (i > theNumberOfCommands) return 0;
theCommands [i]. callback (NULL, arguments, interpreter, command, false, NULL); therror
return 1;
}
long praat_getNumberOfMenuCommands (void) { return theNumberOfCommands; }
praat_Command praat_getMenuCommand (long i)
{ return i < 1 || i > theNumberOfCommands ? NULL : & theCommands [i]; }
void praat_addCommandsToEditor (Editor me) {
const wchar *windowName = my classInfo -> className;
for (long i = 1; i <= theNumberOfCommands; i ++) if (wcsequ (theCommands [i]. window, windowName)) {
if (! Editor_addCommandScript (me, theCommands [i]. menu, theCommands [i]. title, 0, theCommands [i]. script))
Melder_flushError ("To fix this, go to Praat->Preferences->Buttons->Editors, "
"and remove the script from this menu.\n"
"You may want to install the script in a different menu.");
}
}
/* End of file praat_menuCommands.cpp */
|