src/nsfns.m

   1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
   2
   3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2011
   4   Free Software Foundation, Inc.
   5
   6 This file is part of GNU Emacs.
   7
   8 GNU Emacs is free software: you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation, either version 3 of the License, or
  11 (at your option) any later version.
  12
  13 GNU Emacs is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 GNU General Public License for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
  20
  21 /*
  22 Originally by Carl Edman
  23 Updated by Christian Limpach (chris@nice.ch)
  24 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
  25 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
  26 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
  27 */
  28
  29 /* This should be the first include, as it may set up #defines affecting
  30    interpretation of even the system includes. */
  31 #include <config.h>
  32
  33 #include <signal.h>
  34 #include <math.h>
  35 #include <setjmp.h>
  36
  37 #include "lisp.h"
  38 #include "blockinput.h"
  39 #include "nsterm.h"
  40 #include "window.h"
  41 #include "buffer.h"
  42 #include "keyboard.h"
  43 #include "termhooks.h"
  44 #include "fontset.h"
  45 #include "character.h"
  46 #include "font.h"
  47
  48 #if 0
  49 int fns_trace_num = 1;
  50 #define NSTRACE(x)        fprintf (stderr, "%s:%d: [%d] " #x "\n",        \
  51                                   __FILE__, __LINE__, ++fns_trace_num)
  52 #else
  53 #define NSTRACE(x)
  54 #endif
  55
  56 #ifdef HAVE_NS
  57
  58 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
  59
  60 extern Lisp_Object Qforeground_color;
  61 extern Lisp_Object Qbackground_color;
  62 extern Lisp_Object Qcursor_color;
  63 extern Lisp_Object Qinternal_border_width;
  64 extern Lisp_Object Qvisibility;
  65 extern Lisp_Object Qcursor_type;
  66 extern Lisp_Object Qicon_type;
  67 extern Lisp_Object Qicon_name;
  68 extern Lisp_Object Qicon_left;
  69 extern Lisp_Object Qicon_top;
  70 extern Lisp_Object Qleft;
  71 extern Lisp_Object Qright;
  72 extern Lisp_Object Qtop;
  73 extern Lisp_Object Qdisplay;
  74 extern Lisp_Object Qvertical_scroll_bars;
  75 extern Lisp_Object Qauto_raise;
  76 extern Lisp_Object Qauto_lower;
  77 extern Lisp_Object Qbox;
  78 extern Lisp_Object Qscroll_bar_width;
  79 extern Lisp_Object Qx_resource_name;
  80 extern Lisp_Object Qface_set_after_frame_default;
  81 extern Lisp_Object Qunderline, Qundefined;
  82 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
  83 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
  84 extern Lisp_Object Qnone;
  85
  86
  87 Lisp_Object Qbuffered;
  88 Lisp_Object Qfontsize;
  89
  90 /* hack for OS X file panels */
  91 char panelOK = 0;
  92
  93 EmacsTooltip *ns_tooltip;
  94
  95 /* Need forward declaration here to preserve organizational integrity of file */
  96 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
  97
  98 extern BOOL ns_in_resize;
  99
 100 /* Static variables to handle applescript execution.  */
 101 static Lisp_Object as_script, *as_result;
 102 static int as_status;
 103
 104 #if GLYPH_DEBUG
 105 static ptrdiff_t image_cache_refcount;
 106 #endif
 107
 108 /* ==========================================================================
 109
 110     Internal utility functions
 111
 112    ========================================================================== */
 113
 114
 115 void
 116 check_ns (void)
 117 {
 118  if (NSApp == nil)
 119    error ("OpenStep is not in use or not initialized");
 120 }
 121
 122
 123 /* Nonzero if we can use mouse menus. */
 124 int
 125 have_menus_p (void)
 126 {
 127   return NSApp != nil;
 128 }
 129
 130
 131 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
 132    and checking validity for NS.  */
 133 static FRAME_PTR
 134 check_ns_frame (Lisp_Object frame)
 135 {
 136   FRAME_PTR f;
 137
 138   if (NILP (frame))
 139       f = SELECTED_FRAME ();
 140   else
 141     {
 142       CHECK_LIVE_FRAME (frame);
 143       f = XFRAME (frame);
 144     }
 145   if (! FRAME_NS_P (f))
 146     error ("non-Nextstep frame used");
 147   return f;
 148 }
 149
 150
 151 /* Let the user specify an Nextstep display with a frame.
 152    nil stands for the selected frame--or, if that is not an Nextstep frame,
 153    the first Nextstep display on the list.  */
 154 static struct ns_display_info *
 155 check_ns_display_info (Lisp_Object frame)
 156 {
 157   if (NILP (frame))
 158     {
 159       struct frame *f = SELECTED_FRAME ();
 160       if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
 161         return FRAME_NS_DISPLAY_INFO (f);
 162       else if (x_display_list != 0)
 163         return x_display_list;
 164       else
 165         error ("Nextstep windows are not in use or not initialized");
 166     }
 167   else if (INTEGERP (frame))
 168     {
 169       struct terminal *t = get_terminal (frame, 1);
 170
 171       if (t->type != output_ns)
 172         error ("Terminal %ld is not a Nextstep display", (long) XINT (frame));
 173
 174       return t->display_info.ns;
 175     }
 176   else if (STRINGP (frame))
 177     return ns_display_info_for_name (frame);
 178   else
 179     {
 180       FRAME_PTR f;
 181
 182       CHECK_LIVE_FRAME (frame);
 183       f = XFRAME (frame);
 184       if (! FRAME_NS_P (f))
 185         error ("non-Nextstep frame used");
 186       return FRAME_NS_DISPLAY_INFO (f);
 187     }
 188   return NULL;  /* shut compiler up */
 189 }
 190
 191
 192 static id
 193 ns_get_window (Lisp_Object maybeFrame)
 194 {
 195   id view =nil, window =nil;
 196
 197   if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
 198     maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
 199
 200   if (!NILP (maybeFrame))
 201     view = FRAME_NS_VIEW (XFRAME (maybeFrame));
 202   if (view) window =[view window];
 203
 204   return window;
 205 }
 206
 207
 208 static NSScreen *
 209 ns_get_screen (Lisp_Object screen)
 210 {
 211   struct frame *f;
 212   struct terminal *terminal;
 213
 214   if (EQ (Qt, screen)) /* not documented */
 215     return [NSScreen mainScreen];
 216
 217   terminal = get_terminal (screen, 1);
 218   if (terminal->type != output_ns)
 219     return NULL;
 220
 221   if (NILP (screen))
 222     f = SELECTED_FRAME ();
 223   else if (FRAMEP (screen))
 224     f = XFRAME (screen);
 225   else
 226     {
 227       struct ns_display_info *dpyinfo = terminal->display_info.ns;
 228       f = dpyinfo->x_focus_frame
 229         ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
 230     }
 231
 232   return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
 233           : NULL);
 234 }
 235
 236
 237 /* Return the X display structure for the display named NAME.
 238    Open a new connection if necessary.  */
 239 struct ns_display_info *
 240 ns_display_info_for_name (Lisp_Object name)
 241 {
 242   Lisp_Object names;
 243   struct ns_display_info *dpyinfo;
 244
 245   CHECK_STRING (name);
 246
 247   for (dpyinfo = x_display_list, names = ns_display_name_list;
 248        dpyinfo;
 249        dpyinfo = dpyinfo->next, names = XCDR (names))
 250     {
 251       Lisp_Object tem;
 252       tem = Fstring_equal (XCAR (XCAR (names)), name);
 253       if (!NILP (tem))
 254         return dpyinfo;
 255     }
 256
 257   error ("Emacs for OpenStep does not yet support multi-display.");
 258
 259   Fx_open_connection (name, Qnil, Qnil);
 260   dpyinfo = x_display_list;
 261
 262   if (dpyinfo == 0)
 263     error ("OpenStep on %s not responding.\n", SDATA (name));
 264
 265   return dpyinfo;
 266 }
 267
 268
 269 static Lisp_Object
 270 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
 271 /* --------------------------------------------------------------------------
 272    Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
 273    -------------------------------------------------------------------------- */
 274 {
 275   int i, count;
 276   NSMenuItem *item;
 277   const char *name;
 278   Lisp_Object nameStr;
 279   unsigned short key;
 280   NSString *keys;
 281   Lisp_Object res;
 282
 283   count = [menu numberOfItems];
 284   for (i = 0; i<count; i++)
 285     {
 286       item = [menu itemAtIndex: i];
 287       name = [[item title] UTF8String];
 288       if (!name) continue;
 289
 290       nameStr = build_string (name);
 291
 292       if ([item hasSubmenu])
 293         {
 294           old = interpret_services_menu ([item submenu],
 295                                         Fcons (nameStr, prefix), old);
 296         }
 297       else
 298         {
 299           keys = [item keyEquivalent];
 300           if (keys && [keys length] )
 301             {
 302               key = [keys characterAtIndex: 0];
 303               res = make_number (key|super_modifier);
 304             }
 305           else
 306             {
 307               res = Qundefined;
 308             }
 309           old = Fcons (Fcons (res,
 310                             Freverse (Fcons (nameStr,
 311                                            prefix))),
 312                     old);
 313         }
 314     }
 315   return old;
 316 }
 317
 318
 319
 320 /* ==========================================================================
 321
 322     Frame parameter setters
 323
 324    ========================================================================== */
 325
 326
 327 static void
 328 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 329 {
 330   NSColor *col;
 331   CGFloat r, g, b, alpha;
 332
 333   if (ns_lisp_to_color (arg, &col))
 334     {
 335       store_frame_param (f, Qforeground_color, oldval);
 336       error ("Unknown color");
 337     }
 338
 339   [col retain];
 340   [f->output_data.ns->foreground_color release];
 341   f->output_data.ns->foreground_color = col;
 342
 343   [col getRed: &r green: &g blue: &b alpha: &alpha];
 344   FRAME_FOREGROUND_PIXEL (f) =
 345     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
 346
 347   if (FRAME_NS_VIEW (f))
 348     {
 349       update_face_from_frame_parameter (f, Qforeground_color, arg);
 350       /*recompute_basic_faces (f); */
 351       if (FRAME_VISIBLE_P (f))
 352         redraw_frame (f);
 353     }
 354 }
 355
 356
 357 static void
 358 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 359 {
 360   struct face *face;
 361   NSColor *col;
 362   NSView *view = FRAME_NS_VIEW (f);
 363   CGFloat r, g, b, alpha;
 364
 365   if (ns_lisp_to_color (arg, &col))
 366     {
 367       store_frame_param (f, Qbackground_color, oldval);
 368       error ("Unknown color");
 369     }
 370
 371   /* clear the frame; in some instances the NS-internal GC appears not to
 372      update, or it does update and cannot clear old text properly */
 373   if (FRAME_VISIBLE_P (f))
 374     ns_clear_frame (f);
 375
 376   [col retain];
 377   [f->output_data.ns->background_color release];
 378   f->output_data.ns->background_color = col;
 379
 380   [col getRed: &r green: &g blue: &b alpha: &alpha];
 381   FRAME_BACKGROUND_PIXEL (f) =
 382     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
 383
 384   if (view != nil)
 385     {
 386       [[view window] setBackgroundColor: col];
 387
 388       if (alpha != 1.0)
 389           [[view window] setOpaque: NO];
 390       else
 391           [[view window] setOpaque: YES];
 392
 393       face = FRAME_DEFAULT_FACE (f);
 394       if (face)
 395         {
 396           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
 397           face->background
 398              = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
 399           [col release];
 400
 401           update_face_from_frame_parameter (f, Qbackground_color, arg);
 402         }
 403
 404       if (FRAME_VISIBLE_P (f))
 405         redraw_frame (f);
 406     }
 407 }
 408
 409
 410 static void
 411 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 412 {
 413   NSColor *col;
 414
 415   if (ns_lisp_to_color (arg, &col))
 416     {
 417       store_frame_param (f, Qcursor_color, oldval);
 418       error ("Unknown color");
 419     }
 420
 421   [FRAME_CURSOR_COLOR (f) release];
 422   FRAME_CURSOR_COLOR (f) = [col retain];
 423
 424   if (FRAME_VISIBLE_P (f))
 425     {
 426       x_update_cursor (f, 0);
 427       x_update_cursor (f, 1);
 428     }
 429   update_face_from_frame_parameter (f, Qcursor_color, arg);
 430 }
 431
 432
 433 static void
 434 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 435 {
 436   NSView *view = FRAME_NS_VIEW (f);
 437   NSTRACE (x_set_icon_name);
 438
 439   if (ns_in_resize)
 440     return;
 441
 442   /* see if it's changed */
 443   if (STRINGP (arg))
 444     {
 445       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
 446         return;
 447     }
 448   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
 449     return;
 450
 451   f->icon_name = arg;
 452
 453   if (NILP (arg))
 454     {
 455       if (!NILP (f->title))
 456         arg = f->title;
 457       else
 458         /* explicit name and no icon-name -> explicit_name */
 459         if (f->explicit_name)
 460           arg = f->name;
 461         else
 462           {
 463             /* no explicit name and no icon-name ->
 464                name has to be rebuild from icon_title_format */
 465             windows_or_buffers_changed++;
 466             return;
 467           }
 468     }
 469
 470   /* Don't change the name if it's already NAME.  */
 471   if ([[view window] miniwindowTitle] &&
 472       ([[[view window] miniwindowTitle]
 473              isEqualToString: [NSString stringWithUTF8String:
 474                                            SDATA (arg)]]))
 475     return;
 476
 477   [[view window] setMiniwindowTitle:
 478         [NSString stringWithUTF8String: SDATA (arg)]];
 479 }
 480
 481 static void
 482 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
 483 {
 484   struct gcpro gcpro1;
 485   Lisp_Object encoded_name, encoded_icon_name;
 486   NSString *str;
 487   NSView *view = FRAME_NS_VIEW (f);
 488
 489   GCPRO1 (name);
 490   encoded_name = ENCODE_UTF_8 (name);
 491   UNGCPRO;
 492
 493   str = [NSString stringWithUTF8String: SDATA (encoded_name)];
 494
 495   /* Don't change the name if it's already NAME.  */
 496   if (! [[[view window] title] isEqualToString: str])
 497     [[view window] setTitle: str];
 498
 499   if (!STRINGP (f->icon_name))
 500     encoded_icon_name = encoded_name;
 501   else
 502     encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
 503
 504   str = [NSString stringWithUTF8String: SDATA (encoded_icon_name)];
 505
 506   if ([[view window] miniwindowTitle] &&
 507       ! [[[view window] miniwindowTitle] isEqualToString: str])
 508     [[view window] setMiniwindowTitle: str];
 509
 510 }
 511
 512 static void
 513 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
 514 {
 515   NSView *view;
 516   NSTRACE (ns_set_name);
 517
 518   if (ns_in_resize)
 519     return;
 520
 521   /* Make sure that requests from lisp code override requests from
 522      Emacs redisplay code.  */
 523   if (explicit)
 524     {
 525       /* If we're switching from explicit to implicit, we had better
 526          update the mode lines and thereby update the title.  */
 527       if (f->explicit_name && NILP (name))
 528         update_mode_lines = 1;
 529
 530       f->explicit_name = ! NILP (name);
 531     }
 532   else if (f->explicit_name)
 533     return;
 534
 535   if (NILP (name))
 536     name = build_string([ns_app_name UTF8String]);
 537   else
 538     CHECK_STRING (name);
 539
 540   /* Don't change the name if it's already NAME.  */
 541   if (! NILP (Fstring_equal (name, f->name)))
 542     return;
 543
 544   f->name = name;
 545
 546   /* title overrides explicit name */
 547   if (! NILP (f->title))
 548     name = f->title;
 549
 550   ns_set_name_internal (f, name);
 551 }
 552
 553
 554 /* This function should be called when the user's lisp code has
 555    specified a name for the frame; the name will override any set by the
 556    redisplay code.  */
 557 static void
 558 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
 559 {
 560   NSTRACE (x_explicitly_set_name);
 561   ns_set_name (f, arg, 1);
 562 }
 563
 564
 565 /* This function should be called by Emacs redisplay code to set the
 566    name; names set this way will never override names set by the user's
 567    lisp code.  */
 568 void
 569 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
 570 {
 571   NSTRACE (x_implicitly_set_name);
 572
 573   /* Deal with NS specific format t.  */
 574   if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
 575                          || EQ (Vframe_title_format, Qt)))
 576     ns_set_name_as_filename (f);
 577   else
 578     ns_set_name (f, arg, 0);
 579 }
 580
 581
 582 /* Change the title of frame F to NAME.
 583    If NAME is nil, use the frame name as the title.  */
 584
 585 static void
 586 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
 587 {
 588   NSTRACE (x_set_title);
 589   /* Don't change the title if it's already NAME.  */
 590   if (EQ (name, f->title))
 591     return;
 592
 593   update_mode_lines = 1;
 594
 595   f->title = name;
 596
 597   if (NILP (name))
 598     name = f->name;
 599   else
 600     CHECK_STRING (name);
 601
 602   ns_set_name_internal (f, name);
 603 }
 604
 605
 606 void
 607 ns_set_name_as_filename (struct frame *f)
 608 {
 609   NSView *view;
 610   Lisp_Object name, filename;
 611   Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
 612   const char *title;
 613   NSAutoreleasePool *pool;
 614   struct gcpro gcpro1;
 615   Lisp_Object encoded_name, encoded_filename;
 616   NSString *str;
 617   NSTRACE (ns_set_name_as_filename);
 618
 619   if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
 620     return;
 621
 622   BLOCK_INPUT;
 623   pool = [[NSAutoreleasePool alloc] init];
 624   filename = BVAR (XBUFFER (buf), filename);
 625   name = BVAR (XBUFFER (buf), name);
 626
 627   if (NILP (name))
 628     {
 629       if (! NILP (filename))
 630         name = Ffile_name_nondirectory (filename);
 631       else
 632         name = build_string ([ns_app_name UTF8String]);
 633     }
 634
 635   GCPRO1 (name);
 636   encoded_name = ENCODE_UTF_8 (name);
 637   UNGCPRO;
 638
 639   view = FRAME_NS_VIEW (f);
 640
 641   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
 642                                 : [[[view window] title] UTF8String];
 643
 644   if (title && (! strcmp (title, SDATA (encoded_name))))
 645     {
 646       [pool release];
 647       UNBLOCK_INPUT;
 648       return;
 649     }
 650
 651   str = [NSString stringWithUTF8String: SDATA (encoded_name)];
 652   if (str == nil) str = @"Bad coding";
 653
 654   if (FRAME_ICONIFIED_P (f))
 655     [[view window] setMiniwindowTitle: str];
 656   else
 657     {
 658       NSString *fstr;
 659
 660       if (! NILP (filename))
 661         {
 662           GCPRO1 (filename);
 663           encoded_filename = ENCODE_UTF_8 (filename);
 664           UNGCPRO;
 665
 666           fstr = [NSString stringWithUTF8String: SDATA (encoded_filename)];
 667           if (fstr == nil) fstr = @"";
 668 #ifdef NS_IMPL_COCOA
 669           /* work around a bug observed on 10.3 and later where
 670              setTitleWithRepresentedFilename does not clear out previous state
 671              if given filename does not exist */
 672           if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
 673             [[view window] setRepresentedFilename: @""];
 674 #endif
 675         }
 676       else
 677         fstr = @"";
 678
 679       [[view window] setRepresentedFilename: fstr];
 680       [[view window] setTitle: str];
 681       f->name = name;
 682     }
 683
 684   [pool release];
 685   UNBLOCK_INPUT;
 686 }
 687
 688
 689 void
 690 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
 691 {
 692   NSView *view = FRAME_NS_VIEW (f);
 693   NSAutoreleasePool *pool;
 694   if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
 695     {
 696       BLOCK_INPUT;
 697       pool = [[NSAutoreleasePool alloc] init];
 698       [[view window] setDocumentEdited: !NILP (arg)];
 699       [pool release];
 700       UNBLOCK_INPUT;
 701     }
 702 }
 703
 704
 705 void
 706 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
 707 {
 708   int nlines;
 709   int olines = FRAME_MENU_BAR_LINES (f);
 710   if (FRAME_MINIBUF_ONLY_P (f))
 711     return;
 712
 713   if (INTEGERP (value))
 714     nlines = XINT (value);
 715   else
 716     nlines = 0;
 717
 718   FRAME_MENU_BAR_LINES (f) = 0;
 719   if (nlines)
 720     {
 721       FRAME_EXTERNAL_MENU_BAR (f) = 1;
 722       /* does for all frames, whereas we just want for one frame
 723          [NSMenu setMenuBarVisible: YES]; */
 724     }
 725   else
 726     {
 727       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
 728         free_frame_menubar (f);
 729       /*      [NSMenu setMenuBarVisible: NO]; */
 730       FRAME_EXTERNAL_MENU_BAR (f) = 0;
 731     }
 732 }
 733
 734
 735 /* toolbar support */
 736 void
 737 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
 738 {
 739   int nlines;
 740   Lisp_Object root_window;
 741
 742   if (FRAME_MINIBUF_ONLY_P (f))
 743     return;
 744
 745   if (INTEGERP (value) && XINT (value) >= 0)
 746     nlines = XFASTINT (value);
 747   else
 748     nlines = 0;
 749
 750   if (nlines)
 751     {
 752       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
 753       update_frame_tool_bar (f);
 754     }
 755   else
 756     {
 757       if (FRAME_EXTERNAL_TOOL_BAR (f))
 758         {
 759           free_frame_tool_bar (f);
 760           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
 761         }
 762     }
 763
 764   x_set_window_size (f, 0, f->text_cols, f->text_lines);
 765 }
 766
 767
 768 void
 769 ns_implicitly_set_icon_type (struct frame *f)
 770 {
 771   Lisp_Object tem;
 772   EmacsView *view = FRAME_NS_VIEW (f);
 773   id image =nil;
 774   Lisp_Object chain, elt;
 775   NSAutoreleasePool *pool;
 776   BOOL setMini = YES;
 777
 778   NSTRACE (ns_implicitly_set_icon_type);
 779
 780   BLOCK_INPUT;
 781   pool = [[NSAutoreleasePool alloc] init];
 782   if (f->output_data.ns->miniimage
 783       && [[NSString stringWithUTF8String: SDATA (f->name)]
 784                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
 785     {
 786       [pool release];
 787       UNBLOCK_INPUT;
 788       return;
 789     }
 790
 791   tem = assq_no_quit (Qicon_type, f->param_alist);
 792   if (CONSP (tem) && ! NILP (XCDR (tem)))
 793     {
 794       [pool release];
 795       UNBLOCK_INPUT;
 796       return;
 797     }
 798
 799   for (chain = Vns_icon_type_alist;
 800        (image = nil) && CONSP (chain);
 801        chain = XCDR (chain))
 802     {
 803       elt = XCAR (chain);
 804       /* special case: 't' means go by file type */
 805       if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
 806         {
 807           NSString *str
 808              = [NSString stringWithUTF8String: SDATA (f->name)];
 809           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
 810             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
 811         }
 812       else if (CONSP (elt) &&
 813                STRINGP (XCAR (elt)) &&
 814                STRINGP (XCDR (elt)) &&
 815                fast_string_match (XCAR (elt), f->name) >= 0)
 816         {
 817           image = [EmacsImage allocInitFromFile: XCDR (elt)];
 818           if (image == nil)
 819             image = [[NSImage imageNamed:
 820                                [NSString stringWithUTF8String:
 821                                             SDATA (XCDR (elt))]] retain];
 822         }
 823     }
 824
 825   if (image == nil)
 826     {
 827       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
 828       setMini = NO;
 829     }
 830
 831   [f->output_data.ns->miniimage release];
 832   f->output_data.ns->miniimage = image;
 833   [view setMiniwindowImage: setMini];
 834   [pool release];
 835   UNBLOCK_INPUT;
 836 }
 837
 838
 839 static void
 840 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 841 {
 842   EmacsView *view = FRAME_NS_VIEW (f);
 843   id image = nil;
 844   BOOL setMini = YES;
 845
 846   NSTRACE (x_set_icon_type);
 847
 848   if (!NILP (arg) && SYMBOLP (arg))
 849     {
 850       arg =build_string (SDATA (SYMBOL_NAME (arg)));
 851       store_frame_param (f, Qicon_type, arg);
 852     }
 853
 854   /* do it the implicit way */
 855   if (NILP (arg))
 856     {
 857       ns_implicitly_set_icon_type (f);
 858       return;
 859     }
 860
 861   CHECK_STRING (arg);
 862
 863   image = [EmacsImage allocInitFromFile: arg];
 864   if (image == nil)
 865     image =[NSImage imageNamed: [NSString stringWithUTF8String:
 866                                             SDATA (arg)]];
 867
 868   if (image == nil)
 869     {
 870       image = [NSImage imageNamed: @"text"];
 871       setMini = NO;
 872     }
 873
 874   f->output_data.ns->miniimage = image;
 875   [view setMiniwindowImage: setMini];
 876 }
 877
 878
 879 /* Xism; we stub out (we do implement this in ns-win.el) */
 880 int
 881 XParseGeometry (char *string, int *x, int *y,
 882                 unsigned int *width, unsigned int *height)
 883 {
 884   message1 ("Warning: XParseGeometry not supported under NS.\n");
 885   return 0;
 886 }
 887
 888
 889 /* TODO: move to nsterm? */
 890 int
 891 ns_lisp_to_cursor_type (Lisp_Object arg)
 892 {
 893   char *str;
 894   if (XTYPE (arg) == Lisp_String)
 895     str = SDATA (arg);
 896   else if (XTYPE (arg) == Lisp_Symbol)
 897     str = SDATA (SYMBOL_NAME (arg));
 898   else return -1;
 899   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
 900   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
 901   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
 902   if (!strcmp (str, "bar"))     return BAR_CURSOR;
 903   if (!strcmp (str, "no"))      return NO_CURSOR;
 904   return -1;
 905 }
 906
 907
 908 Lisp_Object
 909 ns_cursor_type_to_lisp (int arg)
 910 {
 911   switch (arg)
 912     {
 913     case FILLED_BOX_CURSOR: return Qbox;
 914     case HOLLOW_BOX_CURSOR: return intern ("hollow");
 915     case HBAR_CURSOR:       return intern ("hbar");
 916     case BAR_CURSOR:        return intern ("bar");
 917     case NO_CURSOR:
 918     default:                return intern ("no");
 919     }
 920 }
 921
 922 /* This is the same as the xfns.c definition.  */
 923 void
 924 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
 925 {
 926   set_frame_cursor_types (f, arg);
 927
 928   /* Make sure the cursor gets redrawn.  */
 929   cursor_type_changed = 1;
 930 }
 931 \f
 932
 933 /* called to set mouse pointer color, but all other terms use it to
 934    initialize pointer types (and don't set the color ;) */
 935 static void
 936 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
 937 {
 938   /* don't think we can do this on Nextstep */
 939 }
 940
 941
 942 #define Str(x) #x
 943 #define Xstr(x) Str(x)
 944
 945 static Lisp_Object
 946 ns_appkit_version_str (void)
 947 {
 948   char tmp[80];
 949
 950 #ifdef NS_IMPL_GNUSTEP
 951   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
 952 #elif defined(NS_IMPL_COCOA)
 953   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
 954 #else
 955   tmp = "ns-unknown";
 956 #endif
 957   return build_string (tmp);
 958 }
 959
 960
 961 /* This is for use by x-server-version and collapses all version info we
 962    have into a single int.  For a better picture of the implementation
 963    running, use ns_appkit_version_str.*/
 964 static int
 965 ns_appkit_version_int (void)
 966 {
 967 #ifdef NS_IMPL_GNUSTEP
 968   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
 969 #elif defined(NS_IMPL_COCOA)
 970   return (int)NSAppKitVersionNumber;
 971 #endif
 972   return 0;
 973 }
 974
 975
 976 static void
 977 x_icon (struct frame *f, Lisp_Object parms)
 978 /* --------------------------------------------------------------------------
 979    Strangely-named function to set icon position parameters in frame.
 980    This is irrelevant under OS X, but might be needed under GNUstep,
 981    depending on the window manager used.  Note, this is not a standard
 982    frame parameter-setter; it is called directly from x-create-frame.
 983    -------------------------------------------------------------------------- */
 984 {
 985   Lisp_Object icon_x, icon_y;
 986   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
 987
 988   f->output_data.ns->icon_top = Qnil;
 989   f->output_data.ns->icon_left = Qnil;
 990
 991   /* Set the position of the icon.  */
 992   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
 993   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
 994   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
 995     {
 996       CHECK_NUMBER (icon_x);
 997       CHECK_NUMBER (icon_y);
 998       f->output_data.ns->icon_top = icon_y;
 999       f->output_data.ns->icon_left = icon_x;
1000     }
1001   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1002     error ("Both left and top icon corners of icon must be specified");
1003 }
1004
1005
1006 /* Note: see frame.c for template, also where generic functions are impl */
1007 frame_parm_handler ns_frame_parm_handlers[] =
1008 {
1009   x_set_autoraise, /* generic OK */
1010   x_set_autolower, /* generic OK */
1011   x_set_background_color,
1012   0, /* x_set_border_color,  may be impossible under Nextstep */
1013   0, /* x_set_border_width,  may be impossible under Nextstep */
1014   x_set_cursor_color,
1015   x_set_cursor_type,
1016   x_set_font, /* generic OK */
1017   x_set_foreground_color,
1018   x_set_icon_name,
1019   x_set_icon_type,
1020   x_set_internal_border_width, /* generic OK */
1021   x_set_menu_bar_lines,
1022   x_set_mouse_color,
1023   x_explicitly_set_name,
1024   x_set_scroll_bar_width, /* generic OK */
1025   x_set_title,
1026   x_set_unsplittable, /* generic OK */
1027   x_set_vertical_scroll_bars, /* generic OK */
1028   x_set_visibility, /* generic OK */
1029   x_set_tool_bar_lines,
1030   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1031   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
1032   x_set_screen_gamma, /* generic OK */
1033   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1034   x_set_fringe_width, /* generic OK */
1035   x_set_fringe_width, /* generic OK */
1036   0, /* x_set_wait_for_wm, will ignore */
1037   0,  /* x_set_fullscreen will ignore */
1038   x_set_font_backend, /* generic OK */
1039   x_set_alpha,
1040   0, /* x_set_sticky */
1041   0, /* x_set_tool_bar_position */
1042 };
1043
1044
1045 /* Handler for signals raised during x_create_frame.
1046    FRAME is the frame which is partially constructed.  */
1047
1048 static Lisp_Object
1049 unwind_create_frame (Lisp_Object frame)
1050 {
1051   struct frame *f = XFRAME (frame);
1052
1053   /* If frame is already dead, nothing to do.  This can happen if the
1054      display is disconnected after the frame has become official, but
1055      before x_create_frame removes the unwind protect.  */
1056   if (!FRAME_LIVE_P (f))
1057     return Qnil;
1058
1059   /* If frame is ``official'', nothing to do.  */
1060   if (NILP (Fmemq (frame, Vframe_list)))
1061     {
1062 #if GLYPH_DEBUG && XASSERTS
1063       struct ns_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1064 #endif
1065
1066       x_free_frame_resources (f);
1067       free_glyphs (f);
1068
1069 #if GLYPH_DEBUG
1070       /* Check that reference counts are indeed correct.  */
1071       xassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1072 #endif
1073       return Qt;
1074     }
1075
1076   return Qnil;
1077 }
1078
1079
1080
1081 /* ==========================================================================
1082
1083     Lisp definitions
1084
1085    ========================================================================== */
1086
1087 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1088        1, 1, 0,
1089        doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1090 Return an Emacs frame object.
1091 PARMS is an alist of frame parameters.
1092 If the parameters specify that the frame should not have a minibuffer,
1093 and do not specify a specific minibuffer window to use,
1094 then `default-minibuffer-frame' must be a frame whose minibuffer can
1095 be shared by the new frame.
1096
1097 This function is an internal primitive--use `make-frame' instead.  */)
1098      (Lisp_Object parms)
1099 {
1100   struct frame *f;
1101   Lisp_Object frame, tem;
1102   Lisp_Object name;
1103   int minibuffer_only = 0;
1104   int window_prompting = 0;
1105   int width, height;
1106   int count = specpdl_ptr - specpdl;
1107   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1108   Lisp_Object display;
1109   struct ns_display_info *dpyinfo = NULL;
1110   Lisp_Object parent;
1111   struct kboard *kb;
1112   Lisp_Object tfont, tfontsize;
1113   static int desc_ctr = 1;
1114
1115   check_ns ();
1116
1117   /* x_get_arg modifies parms.  */
1118   parms = Fcopy_alist (parms);
1119
1120   /* Use this general default value to start with
1121      until we know if this frame has a specified name.  */
1122   Vx_resource_name = Vinvocation_name;
1123
1124   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1125   if (EQ (display, Qunbound))
1126     display = Qnil;
1127   dpyinfo = check_ns_display_info (display);
1128   kb = dpyinfo->terminal->kboard;
1129
1130   if (!dpyinfo->terminal->name)
1131     error ("Terminal is not live, can't create new frames on it");
1132
1133   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1134   if (!STRINGP (name)
1135       && ! EQ (name, Qunbound)
1136       && ! NILP (name))
1137     error ("Invalid frame name--not a string or nil");
1138
1139   if (STRINGP (name))
1140     Vx_resource_name = name;
1141
1142   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1143   if (EQ (parent, Qunbound))
1144     parent = Qnil;
1145   if (! NILP (parent))
1146     CHECK_NUMBER (parent);
1147
1148   /* make_frame_without_minibuffer can run Lisp code and garbage collect.  */
1149   /* No need to protect DISPLAY because that's not used after passing
1150      it to make_frame_without_minibuffer.  */
1151   frame = Qnil;
1152   GCPRO4 (parms, parent, name, frame);
1153   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1154                   RES_TYPE_SYMBOL);
1155   if (EQ (tem, Qnone) || NILP (tem))
1156       f = make_frame_without_minibuffer (Qnil, kb, display);
1157   else if (EQ (tem, Qonly))
1158     {
1159       f = make_minibuffer_frame ();
1160       minibuffer_only = 1;
1161     }
1162   else if (WINDOWP (tem))
1163       f = make_frame_without_minibuffer (tem, kb, display);
1164   else
1165       f = make_frame (1);
1166
1167   XSETFRAME (frame, f);
1168   FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1169
1170   f->terminal = dpyinfo->terminal;
1171
1172   f->output_method = output_ns;
1173   f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1174   memset (f->output_data.ns, 0, sizeof *(f->output_data.ns));
1175
1176   FRAME_FONTSET (f) = -1;
1177
1178   f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1179                             RES_TYPE_STRING);
1180   if (! STRINGP (f->icon_name))
1181     f->icon_name = Qnil;
1182
1183   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1184
1185   /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe.  */
1186   record_unwind_protect (unwind_create_frame, frame);
1187
1188   f->output_data.ns->window_desc = desc_ctr++;
1189   if (!NILP (parent))
1190     {
1191       f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1192       f->output_data.ns->explicit_parent = 1;
1193     }
1194   else
1195     {
1196       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1197       f->output_data.ns->explicit_parent = 0;
1198     }
1199
1200   /* Set the name; the functions to which we pass f expect the name to
1201      be set.  */
1202   if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1203     {
1204       f->name = build_string ([ns_app_name UTF8String]);
1205       f->explicit_name = 0;
1206     }
1207   else
1208     {
1209       f->name = name;
1210       f->explicit_name = 1;
1211       specbind (Qx_resource_name, name);
1212     }
1213
1214   f->resx = dpyinfo->resx;
1215   f->resy = dpyinfo->resy;
1216
1217   BLOCK_INPUT;
1218   register_font_driver (&nsfont_driver, f);
1219   x_default_parameter (f, parms, Qfont_backend, Qnil,
1220                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1221
1222   {
1223     /* use for default font name */
1224     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1225     tfontsize = x_default_parameter (f, parms, Qfontsize,
1226                                     make_number (0 /*(int)[font pointSize]*/),
1227                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1228     tfont = x_default_parameter (f, parms, Qfont,
1229                                  build_string ([[font fontName] UTF8String]),
1230                                  "font", "Font", RES_TYPE_STRING);
1231   }
1232   UNBLOCK_INPUT;
1233
1234   x_default_parameter (f, parms, Qborder_width, make_number (0),
1235                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1236   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1237                       "internalBorderWidth", "InternalBorderWidth",
1238                       RES_TYPE_NUMBER);
1239
1240   /* default scrollbars on right on Mac */
1241   {
1242       Lisp_Object spos
1243 #ifdef NS_IMPL_GNUSTEP
1244           = Qt;
1245 #else
1246           = Qright;
1247 #endif
1248       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1249                            "verticalScrollBars", "VerticalScrollBars",
1250                            RES_TYPE_SYMBOL);
1251   }
1252   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1253                       "foreground", "Foreground", RES_TYPE_STRING);
1254   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1255                       "background", "Background", RES_TYPE_STRING);
1256   /* FIXME: not suppported yet in Nextstep */
1257   x_default_parameter (f, parms, Qline_spacing, Qnil,
1258                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1259   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1260                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1261   x_default_parameter (f, parms, Qright_fringe, Qnil,
1262                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1263
1264 #if GLYPH_DEBUG
1265   image_cache_refcount =
1266     FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1267 #endif
1268
1269   init_frame_faces (f);
1270
1271   /* The resources controlling the menu-bar and tool-bar are
1272      processed specially at startup, and reflected in the mode
1273      variables; ignore them here.  */
1274   x_default_parameter (f, parms, Qmenu_bar_lines,
1275                        NILP (Vmenu_bar_mode)
1276                        ? make_number (0) : make_number (1),
1277                        NULL, NULL, RES_TYPE_NUMBER);
1278   x_default_parameter (f, parms, Qtool_bar_lines,
1279                        NILP (Vtool_bar_mode)
1280                        ? make_number (0) : make_number (1),
1281                        NULL, NULL, RES_TYPE_NUMBER);
1282
1283   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1284                        "BufferPredicate", RES_TYPE_SYMBOL);
1285   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1286                        RES_TYPE_STRING);
1287
1288   window_prompting = x_figure_window_size (f, parms, 1);
1289
1290   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1291   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1292
1293   /* NOTE: on other terms, this is done in set_mouse_color, however this
1294      was not getting called under Nextstep */
1295   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1296   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1297   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1298   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1299   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1300   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1301   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1302      = [NSCursor arrowCursor];
1303   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1304
1305   [[EmacsView alloc] initFrameFromEmacs: f];
1306
1307   x_icon (f, parms);
1308
1309   /* ns_display_info does not have a reference_count.  */
1310   f->terminal->reference_count++;
1311
1312   /* It is now ok to make the frame official even if we get an error below.
1313      The frame needs to be on Vframe_list or making it visible won't work. */
1314   Vframe_list = Fcons (frame, Vframe_list);
1315
1316   x_default_parameter (f, parms, Qicon_type, Qnil,
1317                        "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1318
1319   x_default_parameter (f, parms, Qauto_raise, Qnil,
1320                        "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1321   x_default_parameter (f, parms, Qauto_lower, Qnil,
1322                        "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1323   x_default_parameter (f, parms, Qcursor_type, Qbox,
1324                        "cursorType", "CursorType", RES_TYPE_SYMBOL);
1325   x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1326                        "scrollBarWidth", "ScrollBarWidth",
1327                        RES_TYPE_NUMBER);
1328   x_default_parameter (f, parms, Qalpha, Qnil,
1329                        "alpha", "Alpha", RES_TYPE_NUMBER);
1330
1331   width = FRAME_COLS (f);
1332   height = FRAME_LINES (f);
1333
1334   SET_FRAME_COLS (f, 0);
1335   FRAME_LINES (f) = 0;
1336   change_frame_size (f, height, width, 1, 0, 0);
1337
1338   if (! f->output_data.ns->explicit_parent)
1339     {
1340       Lisp_Object visibility;
1341
1342       visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1343                               RES_TYPE_SYMBOL);
1344       if (EQ (visibility, Qunbound))
1345         visibility = Qt;
1346
1347       if (EQ (visibility, Qicon))
1348         x_iconify_frame (f);
1349       else if (! NILP (visibility))
1350         {
1351           x_make_frame_visible (f);
1352           [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1353         }
1354       else
1355         {
1356           /* Must have been Qnil.  */
1357         }
1358     }
1359
1360   if (FRAME_HAS_MINIBUF_P (f)
1361       && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1362           || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1363     KVAR (kb, Vdefault_minibuffer_frame) = frame;
1364
1365   /* All remaining specified parameters, which have not been "used"
1366      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1367   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1368     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1369       f->param_alist = Fcons (XCAR (tem), f->param_alist);
1370
1371   UNGCPRO;
1372
1373   /* Make sure windows on this frame appear in calls to next-window
1374      and similar functions.  */
1375   Vwindow_list = Qnil;
1376
1377   return unbind_to (count, frame);
1378 }
1379
1380
1381 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1382        doc: /* Set the input focus to FRAME.
1383 FRAME nil means use the selected frame.  */)
1384      (Lisp_Object frame)
1385 {
1386   struct frame *f = check_ns_frame (frame);
1387   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1388
1389   if (dpyinfo->x_focus_frame != f)
1390     {
1391       EmacsView *view = FRAME_NS_VIEW (f);
1392       BLOCK_INPUT;
1393       [NSApp activateIgnoringOtherApps: YES];
1394       [[view window] makeKeyAndOrderFront: view];
1395       UNBLOCK_INPUT;
1396     }
1397
1398   return Qnil;
1399 }
1400
1401
1402 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1403        0, 1, "",
1404        doc: /* Pop up the font panel. */)
1405      (Lisp_Object frame)
1406 {
1407   id fm;
1408   struct frame *f;
1409
1410   check_ns ();
1411   fm = [NSFontManager sharedFontManager];
1412   if (NILP (frame))
1413     f = SELECTED_FRAME ();
1414   else
1415     {
1416       CHECK_FRAME (frame);
1417       f = XFRAME (frame);
1418     }
1419
1420   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1421            isMultiple: NO];
1422   [fm orderFrontFontPanel: NSApp];
1423   return Qnil;
1424 }
1425
1426
1427 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1428        0, 1, "",
1429        doc: /* Pop up the color panel.  */)
1430      (Lisp_Object frame)
1431 {
1432   struct frame *f;
1433
1434   check_ns ();
1435   if (NILP (frame))
1436     f = SELECTED_FRAME ();
1437   else
1438     {
1439       CHECK_FRAME (frame);
1440       f = XFRAME (frame);
1441     }
1442
1443   [NSApp orderFrontColorPanel: NSApp];
1444   return Qnil;
1445 }
1446
1447
1448 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1449        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1450 Optional arg DIR, if non-nil, supplies a default directory.
1451 Optional arg MUSTMATCH, if non-nil, means the returned file or
1452 directory must exist.
1453 Optional arg INIT, if non-nil, provides a default file name to use.  */)
1454      (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch, Lisp_Object init)
1455 {
1456   static id fileDelegate = nil;
1457   int ret;
1458   id panel;
1459   Lisp_Object fname;
1460
1461   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1462     [NSString stringWithUTF8String: SDATA (prompt)];
1463   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1464     [NSString stringWithUTF8String: SDATA (BVAR (current_buffer, directory))] :
1465     [NSString stringWithUTF8String: SDATA (dir)];
1466   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1467     [NSString stringWithUTF8String: SDATA (init)];
1468
1469   check_ns ();
1470
1471   if (fileDelegate == nil)
1472     fileDelegate = [EmacsFileDelegate new];
1473
1474   [NSCursor setHiddenUntilMouseMoves: NO];
1475
1476   if ([dirS characterAtIndex: 0] == '~')
1477     dirS = [dirS stringByExpandingTildeInPath];
1478
1479   panel = NILP (mustmatch) ?
1480     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1481
1482   [panel setTitle: promptS];
1483
1484   /* Puma (10.1) does not have */
1485   if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1486     [panel setAllowsOtherFileTypes: YES];
1487
1488   [panel setTreatsFilePackagesAsDirectories: YES];
1489   [panel setDelegate: fileDelegate];
1490
1491   panelOK = 0;
1492   BLOCK_INPUT;
1493   if (NILP (mustmatch))
1494     {
1495       ret = [panel runModalForDirectory: dirS file: initS];
1496     }
1497   else
1498     {
1499       [panel setCanChooseDirectories: YES];
1500       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1501     }
1502
1503   ret = (ret == NSOKButton) || panelOK;
1504
1505   if (ret)
1506     fname = build_string ([[panel filename] UTF8String]);
1507
1508   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1509   UNBLOCK_INPUT;
1510
1511   return ret ? fname : Qnil;
1512 }
1513
1514
1515 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1516        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1517 If OWNER is nil, Emacs is assumed.  */)
1518      (Lisp_Object owner, Lisp_Object name)
1519 {
1520   const char *value;
1521
1522   check_ns ();
1523   if (NILP (owner))
1524     owner = build_string([ns_app_name UTF8String]);
1525   CHECK_STRING (name);
1526 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1527
1528   value =[[[NSUserDefaults standardUserDefaults]
1529             objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1530            UTF8String];
1531
1532   if (value)
1533     return build_string (value);
1534   return Qnil;
1535 }
1536
1537
1538 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1539        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1540 If OWNER is nil, Emacs is assumed.
1541 If VALUE is nil, the default is removed.  */)
1542      (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1543 {
1544   check_ns ();
1545   if (NILP (owner))
1546     owner = build_string ([ns_app_name UTF8String]);
1547   CHECK_STRING (name);
1548   if (NILP (value))
1549     {
1550       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1551                          [NSString stringWithUTF8String: SDATA (name)]];
1552     }
1553   else
1554     {
1555       CHECK_STRING (value);
1556       [[NSUserDefaults standardUserDefaults] setObject:
1557                 [NSString stringWithUTF8String: SDATA (value)]
1558                                         forKey: [NSString stringWithUTF8String:
1559                                                          SDATA (name)]];
1560     }
1561
1562   return Qnil;
1563 }
1564
1565
1566 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1567        Sx_server_max_request_size,
1568        0, 1, 0,
1569        doc: /* This function is a no-op.  It is only present for completeness.  */)
1570      (Lisp_Object display)
1571 {
1572   check_ns ();
1573   /* This function has no real equivalent under NeXTstep.  Return nil to
1574      indicate this. */
1575   return Qnil;
1576 }
1577
1578
1579 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1580        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1581 DISPLAY should be either a frame or a display name (a string).
1582 If omitted or nil, the selected frame's display is used.  */)
1583      (Lisp_Object display)
1584 {
1585 #ifdef NS_IMPL_GNUSTEP
1586   return build_string ("GNU");
1587 #else
1588   return build_string ("Apple");
1589 #endif
1590 }
1591
1592
1593 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1594        doc: /* Return the version numbers of the server of DISPLAY.
1595 The value is a list of three integers: the major and minor
1596 version numbers of the X Protocol in use, and the distributor-specific
1597 release number.  See also the function `x-server-vendor'.
1598
1599 The optional argument DISPLAY specifies which display to ask about.
1600 DISPLAY should be either a frame or a display name (a string).
1601 If omitted or nil, that stands for the selected frame's display.  */)
1602      (Lisp_Object display)
1603 {
1604   /*NOTE: it is unclear what would best correspond with "protocol";
1605           we return 10.3, meaning Panther, since this is roughly the
1606           level that GNUstep's APIs correspond to.
1607           The last number is where we distinguish between the Apple
1608           and GNUstep implementations ("distributor-specific release
1609           number") and give int'ized versions of major.minor. */
1610   return Fcons (make_number (10),
1611                 Fcons (make_number (3),
1612                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1613 }
1614
1615
1616 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1617        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1618 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1619 If omitted or nil, the selected frame's display is used.  */)
1620      (Lisp_Object display)
1621 {
1622   int num;
1623
1624   check_ns ();
1625   num = [[NSScreen screens] count];
1626
1627   return (num != 0) ? make_number (num) : Qnil;
1628 }
1629
1630
1631 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1632        0, 1, 0,
1633        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1634 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1635 If omitted or nil, the selected frame's display is used.  */)
1636      (Lisp_Object display)
1637 {
1638   check_ns ();
1639   return make_number ((int)
1640                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1641 }
1642
1643
1644 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1645        0, 1, 0,
1646        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1647 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1648 If omitted or nil, the selected frame's display is used.  */)
1649      (Lisp_Object display)
1650 {
1651   check_ns ();
1652   return make_number ((int)
1653                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1654 }
1655
1656
1657 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1658        Sx_display_backing_store, 0, 1, 0,
1659        doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1660 The value may be `buffered', `retained', or `non-retained'.
1661 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1662 If omitted or nil, the selected frame's display is used.  */)
1663      (Lisp_Object display)
1664 {
1665   check_ns ();
1666   switch ([ns_get_window (display) backingType])
1667     {
1668     case NSBackingStoreBuffered:
1669       return intern ("buffered");
1670     case NSBackingStoreRetained:
1671       return intern ("retained");
1672     case NSBackingStoreNonretained:
1673       return intern ("non-retained");
1674     default:
1675       error ("Strange value for backingType parameter of frame");
1676     }
1677   return Qnil;  /* not reached, shut compiler up */
1678 }
1679
1680
1681 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1682        Sx_display_visual_class, 0, 1, 0,
1683        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1684 The value is one of the symbols `static-gray', `gray-scale',
1685 `static-color', `pseudo-color', `true-color', or `direct-color'.
1686 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1687 If omitted or nil, the selected frame's display is used.  */)
1688      (Lisp_Object display)
1689 {
1690   NSWindowDepth depth;
1691   check_ns ();
1692   depth = [ns_get_screen (display) depth];
1693
1694   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1695     return intern ("static-gray");
1696   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1697     return intern ("gray-scale");
1698   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1699     return intern ("pseudo-color");
1700   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1701     return intern ("true-color");
1702   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1703     return intern ("direct-color");
1704   else
1705     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1706     return intern ("direct-color");
1707 }
1708
1709
1710 DEFUN ("x-display-save-under", Fx_display_save_under,
1711        Sx_display_save_under, 0, 1, 0,
1712        doc: /* Return t if DISPLAY supports the save-under feature.
1713 The optional argument DISPLAY specifies which display to ask about.
1714 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1715 If omitted or nil, the selected frame's display is used.  */)
1716      (Lisp_Object display)
1717 {
1718   check_ns ();
1719   switch ([ns_get_window (display) backingType])
1720     {
1721     case NSBackingStoreBuffered:
1722       return Qt;
1723
1724     case NSBackingStoreRetained:
1725     case NSBackingStoreNonretained:
1726       return Qnil;
1727
1728     default:
1729       error ("Strange value for backingType parameter of frame");
1730     }
1731   return Qnil;  /* not reached, shut compiler up */
1732 }
1733
1734
1735 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1736        1, 3, 0,
1737        doc: /* Open a connection to a display server.
1738 DISPLAY is the name of the display to connect to.
1739 Optional second arg XRM-STRING is a string of resources in xrdb format.
1740 If the optional third arg MUST-SUCCEED is non-nil,
1741 terminate Emacs if we can't open the connection.
1742 \(In the Nextstep version, the last two arguments are currently ignored.)  */)
1743      (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1744 {
1745   struct ns_display_info *dpyinfo;
1746
1747   CHECK_STRING (display);
1748
1749   nxatoms_of_nsselect ();
1750   dpyinfo = ns_term_init (display);
1751   if (dpyinfo == 0)
1752     {
1753       if (!NILP (must_succeed))
1754         fatal ("OpenStep on %s not responding.\n",
1755                SDATA (display));
1756       else
1757         error ("OpenStep on %s not responding.\n",
1758                SDATA (display));
1759     }
1760
1761   /* Register our external input/output types, used for determining
1762      applicable services and also drag/drop eligibility. */
1763   ns_send_types = [[NSArray arrayWithObjects: NSStringPboardType, nil] retain];
1764   ns_return_types = [[NSArray arrayWithObjects: NSStringPboardType, nil]
1765                       retain];
1766   ns_drag_types = [[NSArray arrayWithObjects:
1767                             NSStringPboardType,
1768                             NSTabularTextPboardType,
1769                             NSFilenamesPboardType,
1770                             NSURLPboardType,
1771                             NSColorPboardType,
1772                             NSFontPboardType, nil] retain];
1773
1774   return Qnil;
1775 }
1776
1777
1778 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1779        1, 1, 0,
1780        doc: /* Close the connection to the current Nextstep display server.
1781 The argument DISPLAY is currently ignored.  */)
1782      (Lisp_Object display)
1783 {
1784   check_ns ();
1785   /*ns_delete_terminal (dpyinfo->terminal); */
1786   [NSApp terminate: NSApp];
1787   return Qnil;
1788 }
1789
1790
1791 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1792        doc: /* Return the list of display names that Emacs has connections to.  */)
1793      (void)
1794 {
1795   Lisp_Object tail, result;
1796
1797   result = Qnil;
1798   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1799     result = Fcons (XCAR (XCAR (tail)), result);
1800
1801   return result;
1802 }
1803
1804
1805 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1806        0, 0, 0,
1807        doc: /* Hides all applications other than Emacs.  */)
1808      (void)
1809 {
1810   check_ns ();
1811   [NSApp hideOtherApplications: NSApp];
1812   return Qnil;
1813 }
1814
1815 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1816        1, 1, 0,
1817        doc: /* If ON is non-nil, the entire Emacs application is hidden.
1818 Otherwise if Emacs is hidden, it is unhidden.
1819 If ON is equal to `activate', Emacs is unhidden and becomes
1820 the active application.  */)
1821      (Lisp_Object on)
1822 {
1823   check_ns ();
1824   if (EQ (on, intern ("activate")))
1825     {
1826       [NSApp unhide: NSApp];
1827       [NSApp activateIgnoringOtherApps: YES];
1828     }
1829   else if (NILP (on))
1830     [NSApp unhide: NSApp];
1831   else
1832     [NSApp hide: NSApp];
1833   return Qnil;
1834 }
1835
1836
1837 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1838        0, 0, 0,
1839        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1840      (void)
1841 {
1842   check_ns ();
1843   [NSApp orderFrontStandardAboutPanel: nil];
1844   return Qnil;
1845 }
1846
1847
1848 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1849        doc: /* Determine font postscript or family name for font NAME.
1850 NAME should be a string containing either the font name or an XLFD
1851 font descriptor.  If string contains `fontset' and not
1852 `fontset-startup', it is left alone. */)
1853      (Lisp_Object name)
1854 {
1855   char *nm;
1856   CHECK_STRING (name);
1857   nm = SDATA (name);
1858
1859   if (nm[0] != '-')
1860     return name;
1861   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1862     return name;
1863
1864   return build_string (ns_xlfd_to_fontname (SDATA (name)));
1865 }
1866
1867
1868 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1869        doc: /* Return a list of all available colors.
1870 The optional argument FRAME is currently ignored.  */)
1871      (Lisp_Object frame)
1872 {
1873   Lisp_Object list = Qnil;
1874   NSEnumerator *colorlists;
1875   NSColorList *clist;
1876
1877   if (!NILP (frame))
1878     {
1879       CHECK_FRAME (frame);
1880       if (! FRAME_NS_P (XFRAME (frame)))
1881         error ("non-Nextstep frame used in `ns-list-colors'");
1882     }
1883
1884   BLOCK_INPUT;
1885
1886   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1887   while (clist = [colorlists nextObject])
1888     {
1889       if ([[clist name] length] < 7 ||
1890           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1891         {
1892           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1893           NSString *cname;
1894           while (cname = [cnames nextObject])
1895             list = Fcons (build_string ([cname UTF8String]), list);
1896 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1897                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1898                                              UTF8String]), list); */
1899         }
1900     }
1901
1902   UNBLOCK_INPUT;
1903
1904   return list;
1905 }
1906
1907
1908 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1909        doc: /* List available Nextstep services by querying NSApp.  */)
1910      (void)
1911 {
1912 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1913   /* You can't get services like this in 10.6+.  */
1914   return Qnil;
1915 #else
1916   Lisp_Object ret = Qnil;
1917   NSMenu *svcs;
1918   id delegate;
1919
1920   check_ns ();
1921   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1922   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
1923   [NSApp registerServicesMenuSendTypes: ns_send_types
1924                            returnTypes: ns_return_types];
1925
1926 /* On Tiger, services menu updating was made lazier (waits for user to
1927    actually click on the menu), so we have to force things along: */
1928 #ifdef NS_IMPL_COCOA
1929   if (NSAppKitVersionNumber >= 744.0)
1930     {
1931       delegate = [svcs delegate];
1932       if (delegate != nil)
1933         {
1934           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1935               [delegate menuNeedsUpdate: svcs];
1936           if ([delegate respondsToSelector:
1937                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1938             {
1939               int i, len = [delegate numberOfItemsInMenu: svcs];
1940               for (i =0; i<len; i++)
1941                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1942               for (i =0; i<len; i++)
1943                   if (![delegate menu: svcs
1944                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1945                               atIndex: i shouldCancel: NO])
1946                     break;
1947             }
1948         }
1949     }
1950 #endif
1951
1952   [svcs setAutoenablesItems: NO];
1953 #ifdef NS_IMPL_COCOA
1954   [svcs update]; /* on OS X, converts from '/' structure */
1955 #endif
1956
1957   ret = interpret_services_menu (svcs, Qnil, ret);
1958   return ret;
1959 #endif
1960 }
1961
1962
1963 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1964        2, 2, 0,
1965        doc: /* Perform Nextstep SERVICE on SEND.
1966 SEND should be either a string or nil.
1967 The return value is the result of the service, as string, or nil if
1968 there was no result.  */)
1969      (Lisp_Object service, Lisp_Object send)
1970 {
1971   id pb;
1972   NSString *svcName;
1973   char *utfStr;
1974   int len;
1975
1976   CHECK_STRING (service);
1977   check_ns ();
1978
1979   utfStr = SDATA (service);
1980   svcName = [NSString stringWithUTF8String: utfStr];
1981
1982   pb =[NSPasteboard pasteboardWithUniqueName];
1983   ns_string_to_pasteboard (pb, send);
1984
1985   if (NSPerformService (svcName, pb) == NO)
1986     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1987
1988   if ([[pb types] count] == 0)
1989     return build_string ("");
1990   return ns_string_from_pasteboard (pb);
1991 }
1992
1993
1994 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1995        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1996        doc: /* Return an NFC string that matches the UTF-8 NFD string STR.  */)
1997      (Lisp_Object str)
1998 {
1999 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2000          remove this. */
2001   NSString *utfStr;
2002
2003   CHECK_STRING (str);
2004   utfStr = [NSString stringWithUTF8String: SDATA (str)];
2005   if (![utfStr respondsToSelector:
2006                  @selector (precomposedStringWithCanonicalMapping)])
2007     {
2008       message1
2009         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2010       return Qnil;
2011     }
2012   else
2013     utfStr = [utfStr precomposedStringWithCanonicalMapping];
2014   return build_string ([utfStr UTF8String]);
2015 }
2016
2017
2018 #ifdef NS_IMPL_COCOA
2019
2020 /* Compile and execute the AppleScript SCRIPT and return the error
2021    status as function value.  A zero is returned if compilation and
2022    execution is successful, in which case *RESULT is set to a Lisp
2023    string or a number containing the resulting script value.  Otherwise,
2024    1 is returned. */
2025 static int
2026 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2027 {
2028   NSAppleEventDescriptor *desc;
2029   NSDictionary* errorDict;
2030   NSAppleEventDescriptor* returnDescriptor = NULL;
2031
2032   NSAppleScript* scriptObject =
2033     [[NSAppleScript alloc] initWithSource:
2034                              [NSString stringWithUTF8String: SDATA (script)]];
2035
2036   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2037   [scriptObject release];
2038
2039   *result = Qnil;
2040
2041   if (returnDescriptor != NULL)
2042     {
2043       // successful execution
2044       if (kAENullEvent != [returnDescriptor descriptorType])
2045         {
2046           *result = Qt;
2047           // script returned an AppleScript result
2048           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2049 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2050               (typeUTF16ExternalRepresentation
2051                == [returnDescriptor descriptorType]) ||
2052 #endif
2053               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2054               (typeCString == [returnDescriptor descriptorType]))
2055             {
2056               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2057               if (desc)
2058                 *result = build_string([[desc stringValue] UTF8String]);
2059             }
2060           else
2061             {
2062               /* use typeUTF16ExternalRepresentation? */
2063               // coerce the result to the appropriate ObjC type
2064               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2065               if (desc)
2066                 *result = make_number([desc int32Value]);
2067             }
2068         }
2069     }
2070   else
2071     {
2072       // no script result, return error
2073       return 1;
2074     }
2075   return 0;
2076 }
2077
2078 /* Helper function called from sendEvent to run applescript
2079    from within the main event loop.  */
2080
2081 void
2082 ns_run_ascript (void)
2083 {
2084   as_status = ns_do_applescript (as_script, as_result);
2085 }
2086
2087 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2088        doc: /* Execute AppleScript SCRIPT and return the result.
2089 If compilation and execution are successful, the resulting script value
2090 is returned as a string, a number or, in the case of other constructs, t.
2091 In case the execution fails, an error is signaled. */)
2092      (Lisp_Object script)
2093 {
2094   Lisp_Object result;
2095   int status;
2096   NSEvent *nxev;
2097
2098   CHECK_STRING (script);
2099   check_ns ();
2100
2101   BLOCK_INPUT;
2102
2103   as_script = script;
2104   as_result = &result;
2105
2106   /* executing apple script requires the event loop to run, otherwise
2107      errors aren't returned and executeAndReturnError hangs forever.
2108      Post an event that runs applescript and then start the event loop.
2109      The event loop is exited when the script is done.  */
2110   nxev = [NSEvent otherEventWithType: NSApplicationDefined
2111                             location: NSMakePoint (0, 0)
2112                        modifierFlags: 0
2113                            timestamp: 0
2114                         windowNumber: [[NSApp mainWindow] windowNumber]
2115                              context: [NSApp context]
2116                              subtype: 0
2117                                data1: 0
2118                                data2: NSAPP_DATA2_RUNASSCRIPT];
2119
2120   [NSApp postEvent: nxev atStart: NO];
2121   [NSApp run];
2122
2123   status = as_status;
2124   as_status = 0;
2125   as_script = Qnil;
2126   as_result = 0;
2127   UNBLOCK_INPUT;
2128   if (status == 0)
2129     return result;
2130   else if (!STRINGP (result))
2131     error ("AppleScript error %d", status);
2132   else
2133     error ("%s", SDATA (result));
2134 }
2135 #endif
2136
2137
2138
2139 /* ==========================================================================
2140
2141     Miscellaneous functions not called through hooks
2142
2143    ========================================================================== */
2144
2145
2146 /* called from image.c */
2147 FRAME_PTR
2148 check_x_frame (Lisp_Object frame)
2149 {
2150   return check_ns_frame (frame);
2151 }
2152
2153
2154 /* called from frame.c */
2155 struct ns_display_info *
2156 check_x_display_info (Lisp_Object frame)
2157 {
2158   return check_ns_display_info (frame);
2159 }
2160
2161
2162 void
2163 x_set_scroll_bar_default_width (struct frame *f)
2164 {
2165   int wid = FRAME_COLUMN_WIDTH (f);
2166   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2167   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2168                                       wid - 1) / wid;
2169 }
2170
2171
2172 /* terms impl this instead of x-get-resource directly */
2173 const char *
2174 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2175 {
2176   /* remove appname prefix; TODO: allow for !="Emacs" */
2177   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2178   const char *res;
2179   check_ns ();
2180
2181   if (inhibit_x_resources)
2182     /* --quick was passed, so this is a no-op.  */
2183     return NULL;
2184
2185   res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2186             [NSString stringWithUTF8String: toCheck]] UTF8String];
2187   return !res ? NULL :
2188       (!strncasecmp (res, "YES", 3) ? "true" :
2189           (!strncasecmp (res, "NO", 2) ? "false" : res));
2190 }
2191
2192
2193 Lisp_Object
2194 x_get_focus_frame (struct frame *frame)
2195 {
2196   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2197   Lisp_Object nsfocus;
2198
2199   if (!dpyinfo->x_focus_frame)
2200     return Qnil;
2201
2202   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2203   return nsfocus;
2204 }
2205
2206
2207 int
2208 x_pixel_width (struct frame *f)
2209 {
2210   return FRAME_PIXEL_WIDTH (f);
2211 }
2212
2213
2214 int
2215 x_pixel_height (struct frame *f)
2216 {
2217   return FRAME_PIXEL_HEIGHT (f);
2218 }
2219
2220
2221 int
2222 x_char_width (struct frame *f)
2223 {
2224   return FRAME_COLUMN_WIDTH (f);
2225 }
2226
2227
2228 int
2229 x_char_height (struct frame *f)
2230 {
2231   return FRAME_LINE_HEIGHT (f);
2232 }
2233
2234
2235 int
2236 x_screen_planes (struct frame *f)
2237 {
2238   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2239 }
2240
2241
2242 void
2243 x_sync (struct frame *f)
2244 {
2245   /* XXX Not implemented XXX */
2246   return;
2247 }
2248
2249
2250
2251 /* ==========================================================================
2252
2253     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2254
2255    ========================================================================== */
2256
2257
2258 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2259        doc: /* Internal function called by `color-defined-p', which see.
2260 \(Note that the Nextstep version of this function ignores FRAME.)  */)
2261      (Lisp_Object color, Lisp_Object frame)
2262 {
2263   NSColor * col;
2264   check_ns ();
2265   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2266 }
2267
2268
2269 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2270        doc: /* Internal function called by `color-values', which see.  */)
2271      (Lisp_Object color, Lisp_Object frame)
2272 {
2273   NSColor * col;
2274   CGFloat red, green, blue, alpha;
2275
2276   check_ns ();
2277   CHECK_STRING (color);
2278
2279   if (ns_lisp_to_color (color, &col))
2280     return Qnil;
2281
2282   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2283         getRed: &red green: &green blue: &blue alpha: &alpha];
2284   return list3 (make_number (lrint (red*65280)),
2285                 make_number (lrint (green*65280)),
2286                 make_number (lrint (blue*65280)));
2287 }
2288
2289
2290 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2291        doc: /* Internal function called by `display-color-p', which see.  */)
2292      (Lisp_Object display)
2293 {
2294   NSWindowDepth depth;
2295   NSString *colorSpace;
2296   check_ns ();
2297   depth = [ns_get_screen (display) depth];
2298   colorSpace = NSColorSpaceFromDepth (depth);
2299
2300   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2301          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2302       ? Qnil : Qt;
2303 }
2304
2305
2306 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2307        Sx_display_grayscale_p, 0, 1, 0,
2308        doc: /* Return t if the Nextstep display supports shades of gray.
2309 Note that color displays do support shades of gray.
2310 The optional argument DISPLAY specifies which display to ask about.
2311 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2312 If omitted or nil, that stands for the selected frame's display. */)
2313      (Lisp_Object display)
2314 {
2315   NSWindowDepth depth;
2316   check_ns ();
2317   depth = [ns_get_screen (display) depth];
2318
2319   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2320 }
2321
2322
2323 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2324        0, 1, 0,
2325        doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2326 The optional argument DISPLAY specifies which display to ask about.
2327 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2328 If omitted or nil, that stands for the selected frame's display.  */)
2329      (Lisp_Object display)
2330 {
2331   check_ns ();
2332   return make_number ((int) [ns_get_screen (display) frame].size.width);
2333 }
2334
2335
2336 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2337        Sx_display_pixel_height, 0, 1, 0,
2338        doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2339 The optional argument DISPLAY specifies which display to ask about.
2340 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2341 If omitted or nil, that stands for the selected frame's display.  */)
2342      (Lisp_Object display)
2343 {
2344   check_ns ();
2345   return make_number ((int) [ns_get_screen (display) frame].size.height);
2346 }
2347
2348
2349 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2350        Sns_display_usable_bounds, 0, 1, 0,
2351        doc: /* Return the bounds of the usable part of the screen.
2352 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2353 are the boundaries of the usable part of the screen, excluding areas
2354 reserved for the Mac menu, dock, and so forth.
2355
2356 The screen queried corresponds to DISPLAY, which should be either a
2357 frame, a display name (a string), or terminal ID.  If omitted or nil,
2358 that stands for the selected frame's display. */)
2359      (Lisp_Object display)
2360 {
2361   int top;
2362   NSScreen *screen;
2363   NSRect vScreen;
2364
2365   check_ns ();
2366   screen = ns_get_screen (display);
2367   if (!screen)
2368     return Qnil;
2369
2370   vScreen = [screen visibleFrame];
2371
2372   /* NS coordinate system is upside-down.
2373      Transform to screen-specific coordinates. */
2374   return list4 (make_number ((int) vScreen.origin.x),
2375                 make_number ((int) [screen frame].size.height
2376                              - vScreen.size.height - vScreen.origin.y),
2377                 make_number ((int) vScreen.size.width),
2378                 make_number ((int) vScreen.size.height));
2379 }
2380
2381
2382 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2383        0, 1, 0,
2384        doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2385 The optional argument DISPLAY specifies which display to ask about.
2386 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2387 If omitted or nil, that stands for the selected frame's display.  */)
2388      (Lisp_Object display)
2389 {
2390   check_ns ();
2391   return make_number
2392     (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2393 }
2394
2395
2396 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2397        Sx_display_color_cells, 0, 1, 0,
2398        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2399 The optional argument DISPLAY specifies which display to ask about.
2400 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2401 If omitted or nil, that stands for the selected frame's display.  */)
2402      (Lisp_Object display)
2403 {
2404   struct ns_display_info *dpyinfo;
2405   check_ns ();
2406
2407   dpyinfo = check_ns_display_info (display);
2408   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2409   return make_number (1 << min (dpyinfo->n_planes, 24));
2410 }
2411
2412
2413 /* Unused dummy def needed for compatibility. */
2414 Lisp_Object tip_frame;
2415
2416 /* TODO: move to xdisp or similar */
2417 static void
2418 compute_tip_xy (struct frame *f,
2419                 Lisp_Object parms,
2420                 Lisp_Object dx,
2421                 Lisp_Object dy,
2422                 int width,
2423                 int height,
2424                 int *root_x,
2425                 int *root_y)
2426 {
2427   Lisp_Object left, top;
2428   EmacsView *view = FRAME_NS_VIEW (f);
2429   NSPoint pt;
2430
2431   /* Start with user-specified or mouse position.  */
2432   left = Fcdr (Fassq (Qleft, parms));
2433   top = Fcdr (Fassq (Qtop, parms));
2434
2435   if (!INTEGERP (left) || !INTEGERP (top))
2436     {
2437       pt = last_mouse_motion_position;
2438       /* Convert to screen coordinates */
2439       pt = [view convertPoint: pt toView: nil];
2440       pt = [[view window] convertBaseToScreen: pt];
2441     }
2442   else
2443     {
2444       /* Absolute coordinates.  */
2445       pt.x = XINT (left);
2446       pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2447         - height;
2448     }
2449
2450   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2451   if (INTEGERP (left))
2452     *root_x = pt.x;
2453   else if (pt.x + XINT (dx) <= 0)
2454     *root_x = 0; /* Can happen for negative dx */
2455   else if (pt.x + XINT (dx) + width
2456            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2457     /* It fits to the right of the pointer.  */
2458     *root_x = pt.x + XINT (dx);
2459   else if (width + XINT (dx) <= pt.x)
2460     /* It fits to the left of the pointer.  */
2461     *root_x = pt.x - width - XINT (dx);
2462   else
2463     /* Put it left justified on the screen -- it ought to fit that way.  */
2464     *root_x = 0;
2465
2466   if (INTEGERP (top))
2467     *root_y = pt.y;
2468   else if (pt.y - XINT (dy) - height >= 0)
2469     /* It fits below the pointer.  */
2470     *root_y = pt.y - height - XINT (dy);
2471   else if (pt.y + XINT (dy) + height
2472            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2473     /* It fits above the pointer */
2474       *root_y = pt.y + XINT (dy);
2475   else
2476     /* Put it on the top.  */
2477     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2478 }
2479
2480
2481 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2482        doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2483 A tooltip window is a small window displaying a string.
2484
2485 This is an internal function; Lisp code should call `tooltip-show'.
2486
2487 FRAME nil or omitted means use the selected frame.
2488
2489 PARMS is an optional list of frame parameters which can be used to
2490 change the tooltip's appearance.
2491
2492 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2493 means use the default timeout of 5 seconds.
2494
2495 If the list of frame parameters PARMS contains a `left' parameter,
2496 the tooltip is displayed at that x-position.  Otherwise it is
2497 displayed at the mouse position, with offset DX added (default is 5 if
2498 DX isn't specified).  Likewise for the y-position; if a `top' frame
2499 parameter is specified, it determines the y-position of the tooltip
2500 window, otherwise it is displayed at the mouse position, with offset
2501 DY added (default is -10).
2502
2503 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2504 Text larger than the specified size is clipped.  */)
2505      (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2506 {
2507   int root_x, root_y;
2508   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2509   int count = SPECPDL_INDEX ();
2510   struct frame *f;
2511   char *str;
2512   NSSize size;
2513
2514   specbind (Qinhibit_redisplay, Qt);
2515
2516   GCPRO4 (string, parms, frame, timeout);
2517
2518   CHECK_STRING (string);
2519   str = SDATA (string);
2520   f = check_x_frame (frame);
2521   if (NILP (timeout))
2522     timeout = make_number (5);
2523   else
2524     CHECK_NATNUM (timeout);
2525
2526   if (NILP (dx))
2527     dx = make_number (5);
2528   else
2529     CHECK_NUMBER (dx);
2530
2531   if (NILP (dy))
2532     dy = make_number (-10);
2533   else
2534     CHECK_NUMBER (dy);
2535
2536   BLOCK_INPUT;
2537   if (ns_tooltip == nil)
2538     ns_tooltip = [[EmacsTooltip alloc] init];
2539   else
2540     Fx_hide_tip ();
2541
2542   [ns_tooltip setText: str];
2543   size = [ns_tooltip frame].size;
2544
2545   /* Move the tooltip window where the mouse pointer is.  Resize and
2546      show it.  */
2547   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2548                   &root_x, &root_y);
2549
2550   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2551   UNBLOCK_INPUT;
2552
2553   UNGCPRO;
2554   return unbind_to (count, Qnil);
2555 }
2556
2557
2558 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2559        doc: /* Hide the current tooltip window, if there is any.
2560 Value is t if tooltip was open, nil otherwise.  */)
2561      (void)
2562 {
2563   if (ns_tooltip == nil || ![ns_tooltip isActive])
2564     return Qnil;
2565   [ns_tooltip hide];
2566   return Qt;
2567 }
2568
2569
2570 /* ==========================================================================
2571
2572     Class implementations
2573
2574    ========================================================================== */
2575
2576
2577 @implementation EmacsSavePanel
2578 #ifdef NS_IMPL_COCOA
2579 /* --------------------------------------------------------------------------
2580    These are overridden to intercept on OS X: ending panel restarts NSApp
2581    event loop if it is stopped.  Not sure if this is correct behavior,
2582    perhaps should check if running and if so send an appdefined.
2583    -------------------------------------------------------------------------- */
2584 - (void) ok: (id)sender
2585 {
2586   [super ok: sender];
2587   panelOK = 1;
2588   [NSApp stop: self];
2589 }
2590 - (void) cancel: (id)sender
2591 {
2592   [super cancel: sender];
2593   [NSApp stop: self];
2594 }
2595 #endif
2596 @end
2597
2598
2599 @implementation EmacsOpenPanel
2600 #ifdef NS_IMPL_COCOA
2601 /* --------------------------------------------------------------------------
2602    These are overridden to intercept on OS X: ending panel restarts NSApp
2603    event loop if it is stopped.  Not sure if this is correct behavior,
2604    perhaps should check if running and if so send an appdefined.
2605    -------------------------------------------------------------------------- */
2606 - (void) ok: (id)sender
2607 {
2608   [super ok: sender];
2609   panelOK = 1;
2610   [NSApp stop: self];
2611 }
2612 - (void) cancel: (id)sender
2613 {
2614   [super cancel: sender];
2615   [NSApp stop: self];
2616 }
2617 #endif
2618 @end
2619
2620
2621 @implementation EmacsFileDelegate
2622 /* --------------------------------------------------------------------------
2623    Delegate methods for Open/Save panels
2624    -------------------------------------------------------------------------- */
2625 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2626 {
2627   return YES;
2628 }
2629 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2630 {
2631   return YES;
2632 }
2633 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2634           confirmed: (BOOL)okFlag
2635 {
2636   return filename;
2637 }
2638 @end
2639
2640 #endif
2641
2642
2643 /* ==========================================================================
2644
2645     Lisp interface declaration
2646
2647    ========================================================================== */
2648
2649
2650 void
2651 syms_of_nsfns (void)
2652 {
2653   int i;
2654
2655   Qfontsize = intern_c_string ("fontsize");
2656   staticpro (&Qfontsize);
2657
2658   DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2659                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2660 If the title of a frame matches REGEXP, then IMAGE.tiff is
2661 selected as the image of the icon representing the frame when it's
2662 miniaturized.  If an element is t, then Emacs tries to select an icon
2663 based on the filetype of the visited file.
2664
2665 The images have to be installed in a folder called English.lproj in the
2666 Emacs folder.  You have to restart Emacs after installing new icons.
2667
2668 Example: Install an icon Gnus.tiff and execute the following code
2669
2670   (setq ns-icon-type-alist
2671         (append ns-icon-type-alist
2672                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2673                    . \"Gnus\"))))
2674
2675 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2676 be used as the image of the icon representing the frame.  */);
2677   Vns_icon_type_alist = Fcons (Qt, Qnil);
2678
2679   DEFVAR_LISP ("ns-version-string", Vns_version_string,
2680                doc: /* Toolkit version for NS Windowing.  */);
2681   Vns_version_string = ns_appkit_version_str ();
2682
2683   defsubr (&Sns_read_file_name);
2684   defsubr (&Sns_get_resource);
2685   defsubr (&Sns_set_resource);
2686   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2687   defsubr (&Sx_display_grayscale_p);
2688   defsubr (&Sns_font_name);
2689   defsubr (&Sns_list_colors);
2690 #ifdef NS_IMPL_COCOA
2691   defsubr (&Sns_do_applescript);
2692 #endif
2693   defsubr (&Sxw_color_defined_p);
2694   defsubr (&Sxw_color_values);
2695   defsubr (&Sx_server_max_request_size);
2696   defsubr (&Sx_server_vendor);
2697   defsubr (&Sx_server_version);
2698   defsubr (&Sx_display_pixel_width);
2699   defsubr (&Sx_display_pixel_height);
2700   defsubr (&Sns_display_usable_bounds);
2701   defsubr (&Sx_display_mm_width);
2702   defsubr (&Sx_display_mm_height);
2703   defsubr (&Sx_display_screens);
2704   defsubr (&Sx_display_planes);
2705   defsubr (&Sx_display_color_cells);
2706   defsubr (&Sx_display_visual_class);
2707   defsubr (&Sx_display_backing_store);
2708   defsubr (&Sx_display_save_under);
2709   defsubr (&Sx_create_frame);
2710   defsubr (&Sx_open_connection);
2711   defsubr (&Sx_close_connection);
2712   defsubr (&Sx_display_list);
2713
2714   defsubr (&Sns_hide_others);
2715   defsubr (&Sns_hide_emacs);
2716   defsubr (&Sns_emacs_info_panel);
2717   defsubr (&Sns_list_services);
2718   defsubr (&Sns_perform_service);
2719   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2720   defsubr (&Sx_focus_frame);
2721   defsubr (&Sns_popup_font_panel);
2722   defsubr (&Sns_popup_color_panel);
2723
2724   defsubr (&Sx_show_tip);
2725   defsubr (&Sx_hide_tip);
2726
2727   /* used only in fontset.c */
2728   check_window_system_func = check_ns;
2729
2730   as_status = 0;
2731   as_script = Qnil;
2732   as_result = 0;
2733 }