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