src/nsfns.m

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