* lisp/emacs-lisp/re-builder.el (reb-color-display-p):
[emacs.git] / src / nsfns.m
blob71f971a9f5b4cdb38bb831b7f78c05b2f96a2c69
1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 1989, 1992-1994, 2005-2006, 2008-2013 Free Software
4 Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
22 Originally by Carl Edman
23 Updated by Christian Limpach (chris@nice.ch)
24 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
25 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
26 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
29 /* This should be the first include, as it may set up #defines affecting
30    interpretation of even the system includes. */
31 #include <config.h>
33 #include <math.h>
34 #include <c-strcase.h>
36 #include "lisp.h"
37 #include "blockinput.h"
38 #include "nsterm.h"
39 #include "window.h"
40 #include "character.h"
41 #include "buffer.h"
42 #include "keyboard.h"
43 #include "termhooks.h"
44 #include "fontset.h"
45 #include "font.h"
47 #ifdef NS_IMPL_COCOA
48 #include <IOKit/graphics/IOGraphicsLib.h>
49 #endif
51 #if 0
52 int fns_trace_num = 1;
53 #define NSTRACE(x)        fprintf (stderr, "%s:%d: [%d] " #x "\n",        \
54                                   __FILE__, __LINE__, ++fns_trace_num)
55 #else
56 #define NSTRACE(x)
57 #endif
59 #ifdef HAVE_NS
61 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
63 extern Lisp_Object Qforeground_color;
64 extern Lisp_Object Qbackground_color;
65 extern Lisp_Object Qcursor_color;
66 extern Lisp_Object Qinternal_border_width;
67 extern Lisp_Object Qvisibility;
68 extern Lisp_Object Qcursor_type;
69 extern Lisp_Object Qicon_type;
70 extern Lisp_Object Qicon_name;
71 extern Lisp_Object Qicon_left;
72 extern Lisp_Object Qicon_top;
73 extern Lisp_Object Qleft;
74 extern Lisp_Object Qright;
75 extern Lisp_Object Qtop;
76 extern Lisp_Object Qdisplay;
77 extern Lisp_Object Qvertical_scroll_bars;
78 extern Lisp_Object Qauto_raise;
79 extern Lisp_Object Qauto_lower;
80 extern Lisp_Object Qbox;
81 extern Lisp_Object Qscroll_bar_width;
82 extern Lisp_Object Qx_resource_name;
83 extern Lisp_Object Qface_set_after_frame_default;
84 extern Lisp_Object Qunderline, Qundefined;
85 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
86 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
89 Lisp_Object Qbuffered;
90 Lisp_Object Qfontsize;
92 EmacsTooltip *ns_tooltip = nil;
94 /* Need forward declaration here to preserve organizational integrity of file */
95 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
97 /* Static variables to handle applescript execution.  */
98 static Lisp_Object as_script, *as_result;
99 static int as_status;
101 #ifdef GLYPH_DEBUG
102 static ptrdiff_t image_cache_refcount;
103 #endif
106 /* ==========================================================================
108     Internal utility functions
110    ========================================================================== */
112 /* Let the user specify a Nextstep display with a Lisp object.
113    OBJECT may be nil, a frame or a terminal object.
114    nil stands for the selected frame--or, if that is not a Nextstep frame,
115    the first Nextstep display on the list.  */
117 static struct ns_display_info *
118 check_ns_display_info (Lisp_Object object)
120   struct ns_display_info *dpyinfo = NULL;
122   if (NILP (object))
123     {
124       struct frame *sf = XFRAME (selected_frame);
126       if (FRAME_NS_P (sf) && FRAME_LIVE_P (sf))
127         dpyinfo = FRAME_NS_DISPLAY_INFO (sf);
128       else if (x_display_list != 0)
129         dpyinfo = x_display_list;
130       else
131         error ("Nextstep windows are not in use or not initialized");
132     }
133   else if (TERMINALP (object))
134     {
135       struct terminal *t = get_terminal (object, 1);
137       if (t->type != output_ns)
138         error ("Terminal %d is not a Nextstep display", t->id);
140       dpyinfo = t->display_info.ns;
141     }
142   else if (STRINGP (object))
143     dpyinfo = ns_display_info_for_name (object);
144   else
145     {
146       FRAME_PTR f = decode_window_system_frame (object);
147       dpyinfo = FRAME_NS_DISPLAY_INFO (f);
148     }
150   return dpyinfo;
154 static id
155 ns_get_window (Lisp_Object maybeFrame)
157   id view =nil, window =nil;
159   if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
160     maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
162   if (!NILP (maybeFrame))
163     view = FRAME_NS_VIEW (XFRAME (maybeFrame));
164   if (view) window =[view window];
166   return window;
170 /* Return the X display structure for the display named NAME.
171    Open a new connection if necessary.  */
172 struct ns_display_info *
173 ns_display_info_for_name (Lisp_Object name)
175   Lisp_Object names;
176   struct ns_display_info *dpyinfo;
178   CHECK_STRING (name);
180   for (dpyinfo = x_display_list, names = ns_display_name_list;
181        dpyinfo;
182        dpyinfo = dpyinfo->next, names = XCDR (names))
183     {
184       Lisp_Object tem;
185       tem = Fstring_equal (XCAR (XCAR (names)), name);
186       if (!NILP (tem))
187         return dpyinfo;
188     }
190   error ("Emacs for OpenStep does not yet support multi-display.");
192   Fx_open_connection (name, Qnil, Qnil);
193   dpyinfo = x_display_list;
195   if (dpyinfo == 0)
196     error ("OpenStep on %s not responding.\n", SDATA (name));
198   return dpyinfo;
201 static NSString *
202 ns_filename_from_panel (NSSavePanel *panel)
204 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
205   NSURL *url = [panel URL];
206   NSString *str = [url path];
207   return str;
208 #else
209   return [panel filename];
210 #endif
213 static NSString *
214 ns_directory_from_panel (NSSavePanel *panel)
216 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
217   NSURL *url = [panel directoryURL];
218   NSString *str = [url path];
219   return str;
220 #else
221   return [panel directory];
222 #endif
225 static Lisp_Object
226 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
227 /* --------------------------------------------------------------------------
228    Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
229    -------------------------------------------------------------------------- */
231   int i, count;
232   NSMenuItem *item;
233   const char *name;
234   Lisp_Object nameStr;
235   unsigned short key;
236   NSString *keys;
237   Lisp_Object res;
239   count = [menu numberOfItems];
240   for (i = 0; i<count; i++)
241     {
242       item = [menu itemAtIndex: i];
243       name = [[item title] UTF8String];
244       if (!name) continue;
246       nameStr = build_string (name);
248       if ([item hasSubmenu])
249         {
250           old = interpret_services_menu ([item submenu],
251                                         Fcons (nameStr, prefix), old);
252         }
253       else
254         {
255           keys = [item keyEquivalent];
256           if (keys && [keys length] )
257             {
258               key = [keys characterAtIndex: 0];
259               res = make_number (key|super_modifier);
260             }
261           else
262             {
263               res = Qundefined;
264             }
265           old = Fcons (Fcons (res,
266                             Freverse (Fcons (nameStr,
267                                            prefix))),
268                     old);
269         }
270     }
271   return old;
276 /* ==========================================================================
278     Frame parameter setters
280    ========================================================================== */
283 static void
284 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
286   NSColor *col;
287   EmacsCGFloat r, g, b, alpha;
289   if (ns_lisp_to_color (arg, &col))
290     {
291       store_frame_param (f, Qforeground_color, oldval);
292       error ("Unknown color");
293     }
295   [col retain];
296   [f->output_data.ns->foreground_color release];
297   f->output_data.ns->foreground_color = col;
299   [col getRed: &r green: &g blue: &b alpha: &alpha];
300   FRAME_FOREGROUND_PIXEL (f) =
301     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
303   if (FRAME_NS_VIEW (f))
304     {
305       update_face_from_frame_parameter (f, Qforeground_color, arg);
306       /*recompute_basic_faces (f); */
307       if (FRAME_VISIBLE_P (f))
308         redraw_frame (f);
309     }
313 static void
314 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
316   struct face *face;
317   NSColor *col;
318   NSView *view = FRAME_NS_VIEW (f);
319   EmacsCGFloat r, g, b, alpha;
321   if (ns_lisp_to_color (arg, &col))
322     {
323       store_frame_param (f, Qbackground_color, oldval);
324       error ("Unknown color");
325     }
327   /* clear the frame; in some instances the NS-internal GC appears not to
328      update, or it does update and cannot clear old text properly */
329   if (FRAME_VISIBLE_P (f))
330     ns_clear_frame (f);
332   [col retain];
333   [f->output_data.ns->background_color release];
334   f->output_data.ns->background_color = col;
336   [col getRed: &r green: &g blue: &b alpha: &alpha];
337   FRAME_BACKGROUND_PIXEL (f) =
338     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
340   if (view != nil)
341     {
342       [[view window] setBackgroundColor: col];
344       if (alpha != (EmacsCGFloat) 1.0)
345           [[view window] setOpaque: NO];
346       else
347           [[view window] setOpaque: YES];
349       face = FRAME_DEFAULT_FACE (f);
350       if (face)
351         {
352           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
353           face->background = ns_index_color
354             ([col colorWithAlphaComponent: alpha], f);
356           update_face_from_frame_parameter (f, Qbackground_color, arg);
357         }
359       if (FRAME_VISIBLE_P (f))
360         redraw_frame (f);
361     }
365 static void
366 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
368   NSColor *col;
370   if (ns_lisp_to_color (arg, &col))
371     {
372       store_frame_param (f, Qcursor_color, oldval);
373       error ("Unknown color");
374     }
376   [FRAME_CURSOR_COLOR (f) release];
377   FRAME_CURSOR_COLOR (f) = [col retain];
379   if (FRAME_VISIBLE_P (f))
380     {
381       x_update_cursor (f, 0);
382       x_update_cursor (f, 1);
383     }
384   update_face_from_frame_parameter (f, Qcursor_color, arg);
388 static void
389 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
391   NSView *view = FRAME_NS_VIEW (f);
392   NSTRACE (x_set_icon_name);
394   /* see if it's changed */
395   if (STRINGP (arg))
396     {
397       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
398         return;
399     }
400   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
401     return;
403   fset_icon_name (f, arg);
405   if (NILP (arg))
406     {
407       if (!NILP (f->title))
408         arg = f->title;
409       else
410         /* explicit name and no icon-name -> explicit_name */
411         if (f->explicit_name)
412           arg = f->name;
413         else
414           {
415             /* no explicit name and no icon-name ->
416                name has to be rebuild from icon_title_format */
417             windows_or_buffers_changed++;
418             return;
419           }
420     }
422   /* Don't change the name if it's already NAME.  */
423   if ([[view window] miniwindowTitle] &&
424       ([[[view window] miniwindowTitle]
425              isEqualToString: [NSString stringWithUTF8String:
426                                            SSDATA (arg)]]))
427     return;
429   [[view window] setMiniwindowTitle:
430         [NSString stringWithUTF8String: SSDATA (arg)]];
433 static void
434 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
436   struct gcpro gcpro1;
437   Lisp_Object encoded_name, encoded_icon_name;
438   NSString *str;
439   NSView *view = FRAME_NS_VIEW (f);
441   GCPRO1 (name);
442   encoded_name = ENCODE_UTF_8 (name);
443   UNGCPRO;
445   str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
447   /* Don't change the name if it's already NAME.  */
448   if (! [[[view window] title] isEqualToString: str])
449     [[view window] setTitle: str];
451   if (!STRINGP (f->icon_name))
452     encoded_icon_name = encoded_name;
453   else
454     encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
456   str = [NSString stringWithUTF8String: SSDATA (encoded_icon_name)];
458   if ([[view window] miniwindowTitle] &&
459       ! [[[view window] miniwindowTitle] isEqualToString: str])
460     [[view window] setMiniwindowTitle: str];
464 static void
465 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
467   NSTRACE (ns_set_name);
469   /* Make sure that requests from lisp code override requests from
470      Emacs redisplay code.  */
471   if (explicit)
472     {
473       /* If we're switching from explicit to implicit, we had better
474          update the mode lines and thereby update the title.  */
475       if (f->explicit_name && NILP (name))
476         update_mode_lines = 1;
478       f->explicit_name = ! NILP (name);
479     }
480   else if (f->explicit_name)
481     return;
483   if (NILP (name))
484     name = build_string([ns_app_name UTF8String]);
485   else
486     CHECK_STRING (name);
488   /* Don't change the name if it's already NAME.  */
489   if (! NILP (Fstring_equal (name, f->name)))
490     return;
492   fset_name (f, name);
494   /* title overrides explicit name */
495   if (! NILP (f->title))
496     name = f->title;
498   ns_set_name_internal (f, name);
502 /* This function should be called when the user's lisp code has
503    specified a name for the frame; the name will override any set by the
504    redisplay code.  */
505 static void
506 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
508   NSTRACE (x_explicitly_set_name);
509   ns_set_name (f, arg, 1);
513 /* This function should be called by Emacs redisplay code to set the
514    name; names set this way will never override names set by the user's
515    lisp code.  */
516 void
517 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
519   NSTRACE (x_implicitly_set_name);
521   /* Deal with NS specific format t.  */
522   if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
523                          || EQ (Vframe_title_format, Qt)))
524     ns_set_name_as_filename (f);
525   else
526     ns_set_name (f, arg, 0);
530 /* Change the title of frame F to NAME.
531    If NAME is nil, use the frame name as the title.  */
533 static void
534 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
536   NSTRACE (x_set_title);
537   /* Don't change the title if it's already NAME.  */
538   if (EQ (name, f->title))
539     return;
541   update_mode_lines = 1;
543   fset_title (f, name);
545   if (NILP (name))
546     name = f->name;
547   else
548     CHECK_STRING (name);
550   ns_set_name_internal (f, name);
554 void
555 ns_set_name_as_filename (struct frame *f)
557   NSView *view;
558   Lisp_Object name, filename;
559   Lisp_Object buf = XWINDOW (f->selected_window)->contents;
560   const char *title;
561   NSAutoreleasePool *pool;
562   struct gcpro gcpro1;
563   Lisp_Object encoded_name, encoded_filename;
564   NSString *str;
565   NSTRACE (ns_set_name_as_filename);
567   if (f->explicit_name || ! NILP (f->title))
568     return;
570   block_input ();
571   pool = [[NSAutoreleasePool alloc] init];
572   filename = BVAR (XBUFFER (buf), filename);
573   name = BVAR (XBUFFER (buf), name);
575   if (NILP (name))
576     {
577       if (! NILP (filename))
578         name = Ffile_name_nondirectory (filename);
579       else
580         name = build_string ([ns_app_name UTF8String]);
581     }
583   GCPRO1 (name);
584   encoded_name = ENCODE_UTF_8 (name);
585   UNGCPRO;
587   view = FRAME_NS_VIEW (f);
589   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
590                                 : [[[view window] title] UTF8String];
592   if (title && (! strcmp (title, SSDATA (encoded_name))))
593     {
594       [pool release];
595       unblock_input ();
596       return;
597     }
599   str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
600   if (str == nil) str = @"Bad coding";
602   if (FRAME_ICONIFIED_P (f))
603     [[view window] setMiniwindowTitle: str];
604   else
605     {
606       NSString *fstr;
608       if (! NILP (filename))
609         {
610           GCPRO1 (filename);
611           encoded_filename = ENCODE_UTF_8 (filename);
612           UNGCPRO;
614           fstr = [NSString stringWithUTF8String: SSDATA (encoded_filename)];
615           if (fstr == nil) fstr = @"";
616 #ifdef NS_IMPL_COCOA
617           /* work around a bug observed on 10.3 and later where
618              setTitleWithRepresentedFilename does not clear out previous state
619              if given filename does not exist */
620           if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
621             [[view window] setRepresentedFilename: @""];
622 #endif
623         }
624       else
625         fstr = @"";
627       [[view window] setRepresentedFilename: fstr];
628       [[view window] setTitle: str];
629       fset_name (f, name);
630     }
632   [pool release];
633   unblock_input ();
637 void
638 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
640   NSView *view = FRAME_NS_VIEW (f);
641   NSAutoreleasePool *pool;
642   if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
643     {
644       block_input ();
645       pool = [[NSAutoreleasePool alloc] init];
646       [[view window] setDocumentEdited: !NILP (arg)];
647       [pool release];
648       unblock_input ();
649     }
653 void
654 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
656   int nlines;
657   if (FRAME_MINIBUF_ONLY_P (f))
658     return;
660   if (TYPE_RANGED_INTEGERP (int, value))
661     nlines = XINT (value);
662   else
663     nlines = 0;
665   FRAME_MENU_BAR_LINES (f) = 0;
666   if (nlines)
667     {
668       FRAME_EXTERNAL_MENU_BAR (f) = 1;
669       /* does for all frames, whereas we just want for one frame
670          [NSMenu setMenuBarVisible: YES]; */
671     }
672   else
673     {
674       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
675         free_frame_menubar (f);
676       /*      [NSMenu setMenuBarVisible: NO]; */
677       FRAME_EXTERNAL_MENU_BAR (f) = 0;
678     }
682 /* toolbar support */
683 void
684 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
686   int nlines;
688   if (FRAME_MINIBUF_ONLY_P (f))
689     return;
691   if (RANGED_INTEGERP (0, value, INT_MAX))
692     nlines = XFASTINT (value);
693   else
694     nlines = 0;
696   if (nlines)
697     {
698       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
699       update_frame_tool_bar (f);
700     }
701   else
702     {
703       if (FRAME_EXTERNAL_TOOL_BAR (f))
704         {
705           free_frame_tool_bar (f);
706           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
707         }
708     }
710   x_set_window_size (f, 0, f->text_cols, f->text_lines);
714 static void
715 ns_implicitly_set_icon_type (struct frame *f)
717   Lisp_Object tem;
718   EmacsView *view = FRAME_NS_VIEW (f);
719   id image = nil;
720   Lisp_Object chain, elt;
721   NSAutoreleasePool *pool;
722   BOOL setMini = YES;
724   NSTRACE (ns_implicitly_set_icon_type);
726   block_input ();
727   pool = [[NSAutoreleasePool alloc] init];
728   if (f->output_data.ns->miniimage
729       && [[NSString stringWithUTF8String: SSDATA (f->name)]
730                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
731     {
732       [pool release];
733       unblock_input ();
734       return;
735     }
737   tem = assq_no_quit (Qicon_type, f->param_alist);
738   if (CONSP (tem) && ! NILP (XCDR (tem)))
739     {
740       [pool release];
741       unblock_input ();
742       return;
743     }
745   for (chain = Vns_icon_type_alist;
746        image == nil && CONSP (chain);
747        chain = XCDR (chain))
748     {
749       elt = XCAR (chain);
750       /* special case: 't' means go by file type */
751       if (SYMBOLP (elt) && EQ (elt, Qt) && SSDATA (f->name)[0] == '/')
752         {
753           NSString *str
754              = [NSString stringWithUTF8String: SSDATA (f->name)];
755           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
756             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
757         }
758       else if (CONSP (elt) &&
759                STRINGP (XCAR (elt)) &&
760                STRINGP (XCDR (elt)) &&
761                fast_string_match (XCAR (elt), f->name) >= 0)
762         {
763           image = [EmacsImage allocInitFromFile: XCDR (elt)];
764           if (image == nil)
765             image = [[NSImage imageNamed:
766                                [NSString stringWithUTF8String:
767                                             SSDATA (XCDR (elt))]] retain];
768         }
769     }
771   if (image == nil)
772     {
773       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
774       setMini = NO;
775     }
777   [f->output_data.ns->miniimage release];
778   f->output_data.ns->miniimage = image;
779   [view setMiniwindowImage: setMini];
780   [pool release];
781   unblock_input ();
785 static void
786 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
788   EmacsView *view = FRAME_NS_VIEW (f);
789   id image = nil;
790   BOOL setMini = YES;
792   NSTRACE (x_set_icon_type);
794   if (!NILP (arg) && SYMBOLP (arg))
795     {
796       arg =build_string (SSDATA (SYMBOL_NAME (arg)));
797       store_frame_param (f, Qicon_type, arg);
798     }
800   /* do it the implicit way */
801   if (NILP (arg))
802     {
803       ns_implicitly_set_icon_type (f);
804       return;
805     }
807   CHECK_STRING (arg);
809   image = [EmacsImage allocInitFromFile: arg];
810   if (image == nil)
811     image =[NSImage imageNamed: [NSString stringWithUTF8String:
812                                             SSDATA (arg)]];
814   if (image == nil)
815     {
816       image = [NSImage imageNamed: @"text"];
817       setMini = NO;
818     }
820   f->output_data.ns->miniimage = image;
821   [view setMiniwindowImage: setMini];
825 /* TODO: move to nsterm? */
827 ns_lisp_to_cursor_type (Lisp_Object arg)
829   char *str;
830   if (XTYPE (arg) == Lisp_String)
831     str = SSDATA (arg);
832   else if (XTYPE (arg) == Lisp_Symbol)
833     str = SSDATA (SYMBOL_NAME (arg));
834   else return -1;
835   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
836   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
837   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
838   if (!strcmp (str, "bar"))     return BAR_CURSOR;
839   if (!strcmp (str, "no"))      return NO_CURSOR;
840   return -1;
844 Lisp_Object
845 ns_cursor_type_to_lisp (int arg)
847   switch (arg)
848     {
849     case FILLED_BOX_CURSOR: return Qbox;
850     case HOLLOW_BOX_CURSOR: return intern ("hollow");
851     case HBAR_CURSOR:       return intern ("hbar");
852     case BAR_CURSOR:        return intern ("bar");
853     case NO_CURSOR:
854     default:                return intern ("no");
855     }
858 /* This is the same as the xfns.c definition.  */
859 static void
860 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
862   set_frame_cursor_types (f, arg);
864   /* Make sure the cursor gets redrawn.  */
865   cursor_type_changed = 1;
869 /* called to set mouse pointer color, but all other terms use it to
870    initialize pointer types (and don't set the color ;) */
871 static void
872 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
874   /* don't think we can do this on Nextstep */
878 #define Str(x) #x
879 #define Xstr(x) Str(x)
881 static Lisp_Object
882 ns_appkit_version_str (void)
884   char tmp[80];
886 #ifdef NS_IMPL_GNUSTEP
887   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
888 #elif defined (NS_IMPL_COCOA)
889   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
890 #else
891   tmp = "ns-unknown";
892 #endif
893   return build_string (tmp);
897 /* This is for use by x-server-version and collapses all version info we
898    have into a single int.  For a better picture of the implementation
899    running, use ns_appkit_version_str.*/
900 static int
901 ns_appkit_version_int (void)
903 #ifdef NS_IMPL_GNUSTEP
904   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
905 #elif defined (NS_IMPL_COCOA)
906   return (int)NSAppKitVersionNumber;
907 #endif
908   return 0;
912 static void
913 x_icon (struct frame *f, Lisp_Object parms)
914 /* --------------------------------------------------------------------------
915    Strangely-named function to set icon position parameters in frame.
916    This is irrelevant under OS X, but might be needed under GNUstep,
917    depending on the window manager used.  Note, this is not a standard
918    frame parameter-setter; it is called directly from x-create-frame.
919    -------------------------------------------------------------------------- */
921   Lisp_Object icon_x, icon_y;
922   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
924   f->output_data.ns->icon_top = Qnil;
925   f->output_data.ns->icon_left = Qnil;
927   /* Set the position of the icon.  */
928   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
929   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
930   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
931     {
932       CHECK_NUMBER (icon_x);
933       CHECK_NUMBER (icon_y);
934       f->output_data.ns->icon_top = icon_y;
935       f->output_data.ns->icon_left = icon_x;
936     }
937   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
938     error ("Both left and top icon corners of icon must be specified");
942 /* Note: see frame.c for template, also where generic functions are impl */
943 frame_parm_handler ns_frame_parm_handlers[] =
945   x_set_autoraise, /* generic OK */
946   x_set_autolower, /* generic OK */
947   x_set_background_color,
948   0, /* x_set_border_color,  may be impossible under Nextstep */
949   0, /* x_set_border_width,  may be impossible under Nextstep */
950   x_set_cursor_color,
951   x_set_cursor_type,
952   x_set_font, /* generic OK */
953   x_set_foreground_color,
954   x_set_icon_name,
955   x_set_icon_type,
956   x_set_internal_border_width, /* generic OK */
957   x_set_menu_bar_lines,
958   x_set_mouse_color,
959   x_explicitly_set_name,
960   x_set_scroll_bar_width, /* generic OK */
961   x_set_title,
962   x_set_unsplittable, /* generic OK */
963   x_set_vertical_scroll_bars, /* generic OK */
964   x_set_visibility, /* generic OK */
965   x_set_tool_bar_lines,
966   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
967   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
968   x_set_screen_gamma, /* generic OK */
969   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
970   x_set_fringe_width, /* generic OK */
971   x_set_fringe_width, /* generic OK */
972   0, /* x_set_wait_for_wm, will ignore */
973   x_set_fullscreen, /* generic OK */
974   x_set_font_backend, /* generic OK */
975   x_set_alpha,
976   0, /* x_set_sticky */
977   0, /* x_set_tool_bar_position */
981 /* Handler for signals raised during x_create_frame.
982    FRAME is the frame which is partially constructed.  */
984 static void
985 unwind_create_frame (Lisp_Object frame)
987   struct frame *f = XFRAME (frame);
989   /* If frame is already dead, nothing to do.  This can happen if the
990      display is disconnected after the frame has become official, but
991      before x_create_frame removes the unwind protect.  */
992   if (!FRAME_LIVE_P (f))
993     return;
995   /* If frame is ``official'', nothing to do.  */
996   if (NILP (Fmemq (frame, Vframe_list)))
997     {
998 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
999       struct ns_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1000 #endif
1002       x_free_frame_resources (f);
1003       free_glyphs (f);
1005 #ifdef GLYPH_DEBUG
1006       /* Check that reference counts are indeed correct.  */
1007       eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1008 #endif
1009     }
1013  * Read geometry related parameters from preferences if not in PARMS.
1014  * Returns the union of parms and any preferences read.
1015  */
1017 static Lisp_Object
1018 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1019                                Lisp_Object parms)
1021   struct {
1022     const char *val;
1023     const char *cls;
1024     Lisp_Object tem;
1025   } r[] = {
1026     { "width",  "Width", Qwidth },
1027     { "height", "Height", Qheight },
1028     { "left", "Left", Qleft },
1029     { "top", "Top", Qtop },
1030   };
1032   int i;
1033   for (i = 0; i < sizeof (r)/sizeof (r[0]); ++i)
1034     {
1035       if (NILP (Fassq (r[i].tem, parms)))
1036         {
1037           Lisp_Object value
1038             = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1039                          RES_TYPE_NUMBER);
1040           if (! EQ (value, Qunbound))
1041             parms = Fcons (Fcons (r[i].tem, value), parms);
1042         }
1043     }
1045   return parms;
1048 /* ==========================================================================
1050     Lisp definitions
1052    ========================================================================== */
1054 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1055        1, 1, 0,
1056        doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1057 Return an Emacs frame object.
1058 PARMS is an alist of frame parameters.
1059 If the parameters specify that the frame should not have a minibuffer,
1060 and do not specify a specific minibuffer window to use,
1061 then `default-minibuffer-frame' must be a frame whose minibuffer can
1062 be shared by the new frame.
1064 This function is an internal primitive--use `make-frame' instead.  */)
1065      (Lisp_Object parms)
1067   struct frame *f;
1068   Lisp_Object frame, tem;
1069   Lisp_Object name;
1070   int minibuffer_only = 0;
1071   long window_prompting = 0;
1072   int width, height;
1073   ptrdiff_t count = specpdl_ptr - specpdl;
1074   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1075   Lisp_Object display;
1076   struct ns_display_info *dpyinfo = NULL;
1077   Lisp_Object parent;
1078   struct kboard *kb;
1079   static int desc_ctr = 1;
1081   /* x_get_arg modifies parms.  */
1082   parms = Fcopy_alist (parms);
1084   /* Use this general default value to start with
1085      until we know if this frame has a specified name.  */
1086   Vx_resource_name = Vinvocation_name;
1088   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1089   if (EQ (display, Qunbound))
1090     display = Qnil;
1091   dpyinfo = check_ns_display_info (display);
1092   kb = dpyinfo->terminal->kboard;
1094   if (!dpyinfo->terminal->name)
1095     error ("Terminal is not live, can't create new frames on it");
1097   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1098   if (!STRINGP (name)
1099       && ! EQ (name, Qunbound)
1100       && ! NILP (name))
1101     error ("Invalid frame name--not a string or nil");
1103   if (STRINGP (name))
1104     Vx_resource_name = name;
1106   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1107   if (EQ (parent, Qunbound))
1108     parent = Qnil;
1109   if (! NILP (parent))
1110     CHECK_NUMBER (parent);
1112   /* make_frame_without_minibuffer can run Lisp code and garbage collect.  */
1113   /* No need to protect DISPLAY because that's not used after passing
1114      it to make_frame_without_minibuffer.  */
1115   frame = Qnil;
1116   GCPRO4 (parms, parent, name, frame);
1117   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1118                   RES_TYPE_SYMBOL);
1119   if (EQ (tem, Qnone) || NILP (tem))
1120       f = make_frame_without_minibuffer (Qnil, kb, display);
1121   else if (EQ (tem, Qonly))
1122     {
1123       f = make_minibuffer_frame ();
1124       minibuffer_only = 1;
1125     }
1126   else if (WINDOWP (tem))
1127       f = make_frame_without_minibuffer (tem, kb, display);
1128   else
1129       f = make_frame (1);
1131   XSETFRAME (frame, f);
1133   f->terminal = dpyinfo->terminal;
1135   f->output_method = output_ns;
1136   f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1138   FRAME_FONTSET (f) = -1;
1140   fset_icon_name (f, x_get_arg (dpyinfo, parms, Qicon_name,
1141                                 "iconName", "Title",
1142                                 RES_TYPE_STRING));
1143   if (! STRINGP (f->icon_name))
1144     fset_icon_name (f, Qnil);
1146   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1148   /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe.  */
1149   record_unwind_protect (unwind_create_frame, frame);
1151   f->output_data.ns->window_desc = desc_ctr++;
1152   if (TYPE_RANGED_INTEGERP (Window, parent))
1153     {
1154       f->output_data.ns->parent_desc = XFASTINT (parent);
1155       f->output_data.ns->explicit_parent = 1;
1156     }
1157   else
1158     {
1159       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1160       f->output_data.ns->explicit_parent = 0;
1161     }
1163   /* Set the name; the functions to which we pass f expect the name to
1164      be set.  */
1165   if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1166     {
1167       fset_name (f, build_string ([ns_app_name UTF8String]));
1168       f->explicit_name = 0;
1169     }
1170   else
1171     {
1172       fset_name (f, name);
1173       f->explicit_name = 1;
1174       specbind (Qx_resource_name, name);
1175     }
1177   block_input ();
1178   register_font_driver (&nsfont_driver, f);
1179   x_default_parameter (f, parms, Qfont_backend, Qnil,
1180                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1182   {
1183     /* use for default font name */
1184     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1185     x_default_parameter (f, parms, Qfontsize,
1186                                     make_number (0 /*(int)[font pointSize]*/),
1187                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1188     x_default_parameter (f, parms, Qfont,
1189                                  build_string ([[font fontName] UTF8String]),
1190                                  "font", "Font", RES_TYPE_STRING);
1191   }
1192   unblock_input ();
1194   x_default_parameter (f, parms, Qborder_width, make_number (0),
1195                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1196   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1197                       "internalBorderWidth", "InternalBorderWidth",
1198                       RES_TYPE_NUMBER);
1200   /* default scrollbars on right on Mac */
1201   {
1202       Lisp_Object spos
1203 #ifdef NS_IMPL_GNUSTEP
1204           = Qt;
1205 #else
1206           = Qright;
1207 #endif
1208       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1209                            "verticalScrollBars", "VerticalScrollBars",
1210                            RES_TYPE_SYMBOL);
1211   }
1212   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1213                       "foreground", "Foreground", RES_TYPE_STRING);
1214   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1215                       "background", "Background", RES_TYPE_STRING);
1216   /* FIXME: not supported yet in Nextstep */
1217   x_default_parameter (f, parms, Qline_spacing, Qnil,
1218                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1219   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1220                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1221   x_default_parameter (f, parms, Qright_fringe, Qnil,
1222                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1224 #ifdef GLYPH_DEBUG
1225   image_cache_refcount =
1226     FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1227 #endif
1229   init_frame_faces (f);
1231   /* The resources controlling the menu-bar and tool-bar are
1232      processed specially at startup, and reflected in the mode
1233      variables; ignore them here.  */
1234   x_default_parameter (f, parms, Qmenu_bar_lines,
1235                        NILP (Vmenu_bar_mode)
1236                        ? make_number (0) : make_number (1),
1237                        NULL, NULL, RES_TYPE_NUMBER);
1238   x_default_parameter (f, parms, Qtool_bar_lines,
1239                        NILP (Vtool_bar_mode)
1240                        ? make_number (0) : make_number (1),
1241                        NULL, NULL, RES_TYPE_NUMBER);
1243   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1244                        "BufferPredicate", RES_TYPE_SYMBOL);
1245   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1246                        RES_TYPE_STRING);
1248   parms = get_geometry_from_preferences (dpyinfo, parms);
1249   window_prompting = x_figure_window_size (f, parms, 1);
1251   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1252   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1254   /* NOTE: on other terms, this is done in set_mouse_color, however this
1255      was not getting called under Nextstep */
1256   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1257   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1258   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1259   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1260   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1261   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1262   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1263      = [NSCursor arrowCursor];
1264   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1266   [[EmacsView alloc] initFrameFromEmacs: f];
1268   x_icon (f, parms);
1270   /* ns_display_info does not have a reference_count.  */
1271   f->terminal->reference_count++;
1273   /* It is now ok to make the frame official even if we get an error below.
1274      The frame needs to be on Vframe_list or making it visible won't work. */
1275   Vframe_list = Fcons (frame, Vframe_list);
1277   x_default_parameter (f, parms, Qicon_type, Qnil,
1278                        "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1280   x_default_parameter (f, parms, Qauto_raise, Qnil,
1281                        "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1282   x_default_parameter (f, parms, Qauto_lower, Qnil,
1283                        "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1284   x_default_parameter (f, parms, Qcursor_type, Qbox,
1285                        "cursorType", "CursorType", RES_TYPE_SYMBOL);
1286   x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1287                        "scrollBarWidth", "ScrollBarWidth",
1288                        RES_TYPE_NUMBER);
1289   x_default_parameter (f, parms, Qalpha, Qnil,
1290                        "alpha", "Alpha", RES_TYPE_NUMBER);
1291   x_default_parameter (f, parms, Qfullscreen, Qnil,
1292                        "fullscreen", "Fullscreen", RES_TYPE_SYMBOL);
1294   width = FRAME_COLS (f);
1295   height = FRAME_LINES (f);
1297   SET_FRAME_COLS (f, 0);
1298   FRAME_LINES (f) = 0;
1299   change_frame_size (f, height, width, 1, 0, 0);
1301   if (! f->output_data.ns->explicit_parent)
1302     {
1303       Lisp_Object visibility;
1305       visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1306                               RES_TYPE_SYMBOL);
1307       if (EQ (visibility, Qunbound))
1308         visibility = Qt;
1310       if (EQ (visibility, Qicon))
1311         x_iconify_frame (f);
1312       else if (! NILP (visibility))
1313         {
1314           x_make_frame_visible (f);
1315           [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1316         }
1317       else
1318         {
1319           /* Must have been Qnil.  */
1320         }
1321     }
1323   if (FRAME_HAS_MINIBUF_P (f)
1324       && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1325           || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1326     kset_default_minibuffer_frame (kb, frame);
1328   /* All remaining specified parameters, which have not been "used"
1329      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1330   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1331     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1332       fset_param_alist (f, Fcons (XCAR (tem), f->param_alist));
1334   UNGCPRO;
1336   if (window_prompting & USPosition)
1337     x_set_offset (f, f->left_pos, f->top_pos, 1);
1339   /* Make sure windows on this frame appear in calls to next-window
1340      and similar functions.  */
1341   Vwindow_list = Qnil;
1343   return unbind_to (count, frame);
1347 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1348        doc: /* Set the input focus to FRAME.
1349 FRAME nil means use the selected frame.  */)
1350      (Lisp_Object frame)
1352   struct frame *f = decode_window_system_frame (frame);
1353   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1355   if (dpyinfo->x_focus_frame != f)
1356     {
1357       EmacsView *view = FRAME_NS_VIEW (f);
1358       block_input ();
1359       [NSApp activateIgnoringOtherApps: YES];
1360       [[view window] makeKeyAndOrderFront: view];
1361       unblock_input ();
1362     }
1364   return Qnil;
1368 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1369        0, 1, "",
1370        doc: /* Pop up the font panel. */)
1371      (Lisp_Object frame)
1373   struct frame *f = decode_window_system_frame (frame);
1374   id fm = [NSFontManager sharedFontManager];
1376   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1377            isMultiple: NO];
1378   [fm orderFrontFontPanel: NSApp];
1379   return Qnil;
1383 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1384        0, 1, "",
1385        doc: /* Pop up the color panel.  */)
1386      (Lisp_Object frame)
1388   check_window_system (NULL);
1389   [NSApp orderFrontColorPanel: NSApp];
1390   return Qnil;
1393 static struct
1395   id panel;
1396   BOOL ret;
1397 #if ! defined (NS_IMPL_COCOA) || \
1398   MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_6
1399   NSString *dirS, *initS;
1400   BOOL no_types;
1401 #endif
1402 } ns_fd_data;
1404 void
1405 ns_run_file_dialog (void)
1407   if (ns_fd_data.panel == nil) return;
1408 #if defined (NS_IMPL_COCOA) && \
1409   MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1410   ns_fd_data.ret = [ns_fd_data.panel runModal];
1411 #else
1412   if (ns_fd_data.no_types)
1413     {
1414       ns_fd_data.ret = [ns_fd_data.panel
1415                            runModalForDirectory: ns_fd_data.dirS
1416                            file: ns_fd_data.initS];
1417     }
1418   else
1419     {
1420       ns_fd_data.ret = [ns_fd_data.panel
1421                            runModalForDirectory: ns_fd_data.dirS
1422                            file: ns_fd_data.initS
1423                            types: nil];
1424     }
1425 #endif
1426   ns_fd_data.panel = nil;
1429 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 5, 0,
1430        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1431 Optional arg DIR, if non-nil, supplies a default directory.
1432 Optional arg MUSTMATCH, if non-nil, means the returned file or
1433 directory must exist.
1434 Optional arg INIT, if non-nil, provides a default file name to use.
1435 Optional arg DIR_ONLY_P, if non-nil, means choose only directories.  */)
1436   (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch,
1437    Lisp_Object init, Lisp_Object dir_only_p)
1439   static id fileDelegate = nil;
1440   BOOL ret;
1441   BOOL isSave = NILP (mustmatch) && NILP (dir_only_p);
1442   id panel;
1443   Lisp_Object fname;
1445   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1446     [NSString stringWithUTF8String: SSDATA (prompt)];
1447   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1448     [NSString stringWithUTF8String: SSDATA (BVAR (current_buffer, directory))] :
1449     [NSString stringWithUTF8String: SSDATA (dir)];
1450   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1451     [NSString stringWithUTF8String: SSDATA (init)];
1452   NSEvent *nxev;
1454   check_window_system (NULL);
1456   if (fileDelegate == nil)
1457     fileDelegate = [EmacsFileDelegate new];
1459   [NSCursor setHiddenUntilMouseMoves: NO];
1461   if ([dirS characterAtIndex: 0] == '~')
1462     dirS = [dirS stringByExpandingTildeInPath];
1464   panel = isSave ?
1465     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1467   [panel setTitle: promptS];
1469   [panel setAllowsOtherFileTypes: YES];
1470   [panel setTreatsFilePackagesAsDirectories: YES];
1471   [panel setDelegate: fileDelegate];
1473   if (! NILP (dir_only_p))
1474     {
1475       [panel setCanChooseDirectories: YES];
1476       [panel setCanChooseFiles: NO];
1477     }
1478   else if (! isSave)
1479     {
1480       /* This is not quite what the documentation says, but it is compatible
1481          with the Gtk+ code.  Also, the menu entry says "Open File...".  */
1482       [panel setCanChooseDirectories: NO];
1483       [panel setCanChooseFiles: YES];
1484     }
1486   block_input ();
1487   ns_fd_data.panel = panel;
1488   ns_fd_data.ret = NO;
1489 #if defined (NS_IMPL_COCOA) && \
1490   MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1491   if (! NILP (mustmatch) || ! NILP (dir_only_p))
1492     [panel setAllowedFileTypes: nil];
1493   if (dirS) [panel setDirectoryURL: [NSURL fileURLWithPath: dirS]];
1494   if (initS && NILP (Ffile_directory_p (init)))
1495     [panel setNameFieldStringValue: [initS lastPathComponent]];
1496   else
1497     [panel setNameFieldStringValue: @""];
1499 #else
1500   ns_fd_data.no_types = NILP (mustmatch) && NILP (dir_only_p);
1501   ns_fd_data.dirS = dirS;
1502   ns_fd_data.initS = initS;
1503 #endif
1505   /* runModalForDirectory/runModal restarts the main event loop when done,
1506      so we must start an event loop and then pop up the file dialog.
1507      The file dialog may pop up a confirm dialog after Ok has been pressed,
1508      so we can not simply pop down on the Ok/Cancel press.
1509    */
1510   nxev = [NSEvent otherEventWithType: NSApplicationDefined
1511                             location: NSMakePoint (0, 0)
1512                        modifierFlags: 0
1513                            timestamp: 0
1514                         windowNumber: [[NSApp mainWindow] windowNumber]
1515                              context: [NSApp context]
1516                              subtype: 0
1517                                data1: 0
1518                                data2: NSAPP_DATA2_RUNFILEDIALOG];
1520   [NSApp postEvent: nxev atStart: NO];
1521   while (ns_fd_data.panel != nil)
1522     [NSApp run];
1524   ret = (ns_fd_data.ret == NSOKButton);
1526   if (ret)
1527     {
1528       NSString *str = ns_filename_from_panel (panel);
1529       if (! str) str = ns_directory_from_panel (panel);
1530       if (! str) ret = NO;
1531       else fname = build_string ([str UTF8String]);
1532     }
1534   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1535   unblock_input ();
1537   return ret ? fname : Qnil;
1540 const char *
1541 ns_get_defaults_value (const char *key)
1543   NSObject *obj = [[NSUserDefaults standardUserDefaults]
1544                     objectForKey: [NSString stringWithUTF8String: key]];
1546   if (!obj) return NULL;
1548   return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1552 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1553        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1554 If OWNER is nil, Emacs is assumed.  */)
1555      (Lisp_Object owner, Lisp_Object name)
1557   const char *value;
1559   check_window_system (NULL);
1560   if (NILP (owner))
1561     owner = build_string([ns_app_name UTF8String]);
1562   CHECK_STRING (name);
1564   value = ns_get_defaults_value (SSDATA (name));
1566   if (value)
1567     return build_string (value);
1568   return Qnil;
1572 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1573        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1574 If OWNER is nil, Emacs is assumed.
1575 If VALUE is nil, the default is removed.  */)
1576      (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1578   check_window_system (NULL);
1579   if (NILP (owner))
1580     owner = build_string ([ns_app_name UTF8String]);
1581   CHECK_STRING (name);
1582   if (NILP (value))
1583     {
1584       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1585                          [NSString stringWithUTF8String: SSDATA (name)]];
1586     }
1587   else
1588     {
1589       CHECK_STRING (value);
1590       [[NSUserDefaults standardUserDefaults] setObject:
1591                 [NSString stringWithUTF8String: SSDATA (value)]
1592                                         forKey: [NSString stringWithUTF8String:
1593                                                          SSDATA (name)]];
1594     }
1596   return Qnil;
1600 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1601        Sx_server_max_request_size,
1602        0, 1, 0,
1603        doc: /* This function is a no-op.  It is only present for completeness.  */)
1604      (Lisp_Object terminal)
1606   check_ns_display_info (terminal);
1607   /* This function has no real equivalent under NeXTstep.  Return nil to
1608      indicate this. */
1609   return Qnil;
1613 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1614        doc: /* Return the "vendor ID" string of Nextstep display server TERMINAL.
1615 \(Labeling every distributor as a "vendor" embodies the false assumption
1616 that operating systems cannot be developed and distributed noncommercially.)
1617 The optional argument TERMINAL specifies which display to ask about.
1618 TERMINAL should be a terminal object, a frame or a display name (a string).
1619 If omitted or nil, that stands for the selected frame's display.  */)
1620   (Lisp_Object terminal)
1622   check_ns_display_info (terminal);
1623 #ifdef NS_IMPL_GNUSTEP
1624   return build_string ("GNU");
1625 #else
1626   return build_string ("Apple");
1627 #endif
1631 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1632        doc: /* Return the version numbers of the server of display TERMINAL.
1633 The value is a list of three integers: the major and minor
1634 version numbers of the X Protocol in use, and the distributor-specific release
1635 number.  See also the function `x-server-vendor'.
1637 The optional argument TERMINAL specifies which display to ask about.
1638 TERMINAL should be a terminal object, a frame or a display name (a string).
1639 If omitted or nil, that stands for the selected frame's display.  */)
1640   (Lisp_Object terminal)
1642   check_ns_display_info (terminal);
1643   /*NOTE: it is unclear what would best correspond with "protocol";
1644           we return 10.3, meaning Panther, since this is roughly the
1645           level that GNUstep's APIs correspond to.
1646           The last number is where we distinguish between the Apple
1647           and GNUstep implementations ("distributor-specific release
1648           number") and give int'ized versions of major.minor. */
1649   return list3i (10, 3, ns_appkit_version_int ());
1653 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1654        doc: /* Return the number of screens on Nextstep display server TERMINAL.
1655 The optional argument TERMINAL specifies which display to ask about.
1656 TERMINAL should be a terminal object, a frame or a display name (a string).
1657 If omitted or nil, that stands for the selected frame's display.
1659 Note: "screen" here is not in Nextstep terminology but in X11's.  For
1660 the number of physical monitors, use `(length
1661 (display-monitor-attributes-list TERMINAL))' instead.  */)
1662   (Lisp_Object terminal)
1664   check_ns_display_info (terminal);
1665   return make_number (1);
1669 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height, 0, 1, 0,
1670        doc: /* Return the height in millimeters of the Nextstep display TERMINAL.
1671 The optional argument TERMINAL specifies which display to ask about.
1672 TERMINAL should be a terminal object, a frame or a display name (a string).
1673 If omitted or nil, that stands for the selected frame's display.
1675 On \"multi-monitor\" setups this refers to the height in millimeters for
1676 all physical monitors associated with TERMINAL.  To get information
1677 for each physical monitor, use `display-monitor-attributes-list'.  */)
1678   (Lisp_Object terminal)
1680   struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1682   return make_number (x_display_pixel_height (dpyinfo) / (92.0/25.4));
1686 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width, 0, 1, 0,
1687        doc: /* Return the width in millimeters of the Nextstep display TERMINAL.
1688 The optional argument TERMINAL specifies which display to ask about.
1689 TERMINAL should be a terminal object, a frame or a display name (a string).
1690 If omitted or nil, that stands for the selected frame's display.
1692 On \"multi-monitor\" setups this refers to the width in millimeters for
1693 all physical monitors associated with TERMINAL.  To get information
1694 for each physical monitor, use `display-monitor-attributes-list'.  */)
1695   (Lisp_Object terminal)
1697   struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
1699   return make_number (x_display_pixel_width (dpyinfo) / (92.0/25.4));
1703 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1704        Sx_display_backing_store, 0, 1, 0,
1705        doc: /* Return an indication of whether the Nextstep display TERMINAL does backing store.
1706 The value may be `buffered', `retained', or `non-retained'.
1707 The optional argument TERMINAL specifies which display to ask about.
1708 TERMINAL should be a terminal object, a frame or a display name (a string).
1709 If omitted or nil, that stands for the selected frame's display.  */)
1710   (Lisp_Object terminal)
1712   check_ns_display_info (terminal);
1713   switch ([ns_get_window (terminal) backingType])
1714     {
1715     case NSBackingStoreBuffered:
1716       return intern ("buffered");
1717     case NSBackingStoreRetained:
1718       return intern ("retained");
1719     case NSBackingStoreNonretained:
1720       return intern ("non-retained");
1721     default:
1722       error ("Strange value for backingType parameter of frame");
1723     }
1724   return Qnil;  /* not reached, shut compiler up */
1728 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1729        Sx_display_visual_class, 0, 1, 0,
1730        doc: /* Return the visual class of the Nextstep display TERMINAL.
1731 The value is one of the symbols `static-gray', `gray-scale',
1732 `static-color', `pseudo-color', `true-color', or `direct-color'.
1734 The optional argument TERMINAL specifies which display to ask about.
1735 TERMINAL should a terminal object, a frame or a display name (a string).
1736 If omitted or nil, that stands for the selected frame's display.  */)
1737   (Lisp_Object terminal)
1739   NSWindowDepth depth;
1741   check_ns_display_info (terminal);
1742   depth = [[[NSScreen screens] objectAtIndex:0] depth];
1744   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1745     return intern ("static-gray");
1746   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1747     return intern ("gray-scale");
1748   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1749     return intern ("pseudo-color");
1750   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1751     return intern ("true-color");
1752   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1753     return intern ("direct-color");
1754   else
1755     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1756     return intern ("direct-color");
1760 DEFUN ("x-display-save-under", Fx_display_save_under,
1761        Sx_display_save_under, 0, 1, 0,
1762        doc: /* Return t if TERMINAL supports the save-under feature.
1763 The optional argument TERMINAL specifies which display to ask about.
1764 TERMINAL should be a terminal object, a frame or a display name (a string).
1765 If omitted or nil, that stands for the selected frame's display.  */)
1766   (Lisp_Object terminal)
1768   check_ns_display_info (terminal);
1769   switch ([ns_get_window (terminal) backingType])
1770     {
1771     case NSBackingStoreBuffered:
1772       return Qt;
1774     case NSBackingStoreRetained:
1775     case NSBackingStoreNonretained:
1776       return Qnil;
1778     default:
1779       error ("Strange value for backingType parameter of frame");
1780     }
1781   return Qnil;  /* not reached, shut compiler up */
1785 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1786        1, 3, 0,
1787        doc: /* Open a connection to a display server.
1788 DISPLAY is the name of the display to connect to.
1789 Optional second arg XRM-STRING is a string of resources in xrdb format.
1790 If the optional third arg MUST-SUCCEED is non-nil,
1791 terminate Emacs if we can't open the connection.
1792 \(In the Nextstep version, the last two arguments are currently ignored.)  */)
1793      (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1795   struct ns_display_info *dpyinfo;
1797   CHECK_STRING (display);
1799   nxatoms_of_nsselect ();
1800   dpyinfo = ns_term_init (display);
1801   if (dpyinfo == 0)
1802     {
1803       if (!NILP (must_succeed))
1804         fatal ("OpenStep on %s not responding.\n",
1805                SSDATA (display));
1806       else
1807         error ("OpenStep on %s not responding.\n",
1808                SSDATA (display));
1809     }
1811   return Qnil;
1815 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1816        1, 1, 0,
1817        doc: /* Close the connection to TERMINAL's Nextstep display server.
1818 For TERMINAL, specify a terminal object, a frame or a display name (a
1819 string).  If TERMINAL is nil, that stands for the selected frame's
1820 terminal.  */)
1821      (Lisp_Object terminal)
1823   check_ns_display_info (terminal);
1824   [NSApp terminate: NSApp];
1825   return Qnil;
1829 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1830        doc: /* Return the list of display names that Emacs has connections to.  */)
1831      (void)
1833   Lisp_Object tail, result;
1835   result = Qnil;
1836   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1837     result = Fcons (XCAR (XCAR (tail)), result);
1839   return result;
1843 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1844        0, 0, 0,
1845        doc: /* Hides all applications other than Emacs.  */)
1846      (void)
1848   check_window_system (NULL);
1849   [NSApp hideOtherApplications: NSApp];
1850   return Qnil;
1853 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1854        1, 1, 0,
1855        doc: /* If ON is non-nil, the entire Emacs application is hidden.
1856 Otherwise if Emacs is hidden, it is unhidden.
1857 If ON is equal to `activate', Emacs is unhidden and becomes
1858 the active application.  */)
1859      (Lisp_Object on)
1861   check_window_system (NULL);
1862   if (EQ (on, intern ("activate")))
1863     {
1864       [NSApp unhide: NSApp];
1865       [NSApp activateIgnoringOtherApps: YES];
1866     }
1867   else if (NILP (on))
1868     [NSApp unhide: NSApp];
1869   else
1870     [NSApp hide: NSApp];
1871   return Qnil;
1875 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1876        0, 0, 0,
1877        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1878      (void)
1880   check_window_system (NULL);
1881   [NSApp orderFrontStandardAboutPanel: nil];
1882   return Qnil;
1886 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1887        doc: /* Determine font PostScript or family name for font NAME.
1888 NAME should be a string containing either the font name or an XLFD
1889 font descriptor.  If string contains `fontset' and not
1890 `fontset-startup', it is left alone. */)
1891      (Lisp_Object name)
1893   char *nm;
1894   CHECK_STRING (name);
1895   nm = SSDATA (name);
1897   if (nm[0] != '-')
1898     return name;
1899   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1900     return name;
1902   return build_string (ns_xlfd_to_fontname (SSDATA (name)));
1906 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1907        doc: /* Return a list of all available colors.
1908 The optional argument FRAME is currently ignored.  */)
1909      (Lisp_Object frame)
1911   Lisp_Object list = Qnil;
1912   NSEnumerator *colorlists;
1913   NSColorList *clist;
1915   if (!NILP (frame))
1916     {
1917       CHECK_FRAME (frame);
1918       if (! FRAME_NS_P (XFRAME (frame)))
1919         error ("non-Nextstep frame used in `ns-list-colors'");
1920     }
1922   block_input ();
1924   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1925   while ((clist = [colorlists nextObject]))
1926     {
1927       if ([[clist name] length] < 7 ||
1928           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1929         {
1930           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1931           NSString *cname;
1932           while ((cname = [cnames nextObject]))
1933             list = Fcons (build_string ([cname UTF8String]), list);
1934 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1935                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1936                                              UTF8String]), list); */
1937         }
1938     }
1940   unblock_input ();
1942   return list;
1946 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1947        doc: /* List available Nextstep services by querying NSApp.  */)
1948      (void)
1950 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1951   /* You can't get services like this in 10.6+.  */
1952   return Qnil;
1953 #else
1954   Lisp_Object ret = Qnil;
1955   NSMenu *svcs;
1956 #ifdef NS_IMPL_COCOA
1957   id delegate;
1958 #endif
1960   check_window_system (NULL);
1961   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1962   [NSApp setServicesMenu: svcs];
1963   [NSApp registerServicesMenuSendTypes: ns_send_types
1964                            returnTypes: ns_return_types];
1966 /* On Tiger, services menu updating was made lazier (waits for user to
1967    actually click on the menu), so we have to force things along: */
1968 #ifdef NS_IMPL_COCOA
1969   delegate = [svcs delegate];
1970   if (delegate != nil)
1971     {
1972       if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1973         [delegate menuNeedsUpdate: svcs];
1974       if ([delegate respondsToSelector:
1975                        @selector (menu:updateItem:atIndex:shouldCancel:)])
1976         {
1977           int i, len = [delegate numberOfItemsInMenu: svcs];
1978           for (i =0; i<len; i++)
1979             [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1980           for (i =0; i<len; i++)
1981             if (![delegate menu: svcs
1982                      updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1983                         atIndex: i shouldCancel: NO])
1984               break;
1985         }
1986     }
1987 #endif
1989   [svcs setAutoenablesItems: NO];
1990 #ifdef NS_IMPL_COCOA
1991   [svcs update]; /* on OS X, converts from '/' structure */
1992 #endif
1994   ret = interpret_services_menu (svcs, Qnil, ret);
1995   return ret;
1996 #endif
2000 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2001        2, 2, 0,
2002        doc: /* Perform Nextstep SERVICE on SEND.
2003 SEND should be either a string or nil.
2004 The return value is the result of the service, as string, or nil if
2005 there was no result.  */)
2006      (Lisp_Object service, Lisp_Object send)
2008   id pb;
2009   NSString *svcName;
2010   char *utfStr;
2012   CHECK_STRING (service);
2013   check_window_system (NULL);
2015   utfStr = SSDATA (service);
2016   svcName = [NSString stringWithUTF8String: utfStr];
2018   pb =[NSPasteboard pasteboardWithUniqueName];
2019   ns_string_to_pasteboard (pb, send);
2021   if (NSPerformService (svcName, pb) == NO)
2022     Fsignal (Qquit, list1 (build_string ("service not available")));
2024   if ([[pb types] count] == 0)
2025     return build_string ("");
2026   return ns_string_from_pasteboard (pb);
2030 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2031        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2032        doc: /* Return an NFC string that matches the UTF-8 NFD string STR.  */)
2033      (Lisp_Object str)
2035 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2036          remove this. */
2037   NSString *utfStr;
2039   CHECK_STRING (str);
2040   utfStr = [NSString stringWithUTF8String: SSDATA (str)];
2041 #ifdef NS_IMPL_COCOA
2042     utfStr = [utfStr precomposedStringWithCanonicalMapping];
2043 #endif
2044   return build_string ([utfStr UTF8String]);
2048 #ifdef NS_IMPL_COCOA
2050 /* Compile and execute the AppleScript SCRIPT and return the error
2051    status as function value.  A zero is returned if compilation and
2052    execution is successful, in which case *RESULT is set to a Lisp
2053    string or a number containing the resulting script value.  Otherwise,
2054    1 is returned. */
2055 static int
2056 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2058   NSAppleEventDescriptor *desc;
2059   NSDictionary* errorDict;
2060   NSAppleEventDescriptor* returnDescriptor = NULL;
2062   NSAppleScript* scriptObject =
2063     [[NSAppleScript alloc] initWithSource:
2064                              [NSString stringWithUTF8String: SSDATA (script)]];
2066   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2067   [scriptObject release];
2069   *result = Qnil;
2071   if (returnDescriptor != NULL)
2072     {
2073       // successful execution
2074       if (kAENullEvent != [returnDescriptor descriptorType])
2075         {
2076           *result = Qt;
2077           // script returned an AppleScript result
2078           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2079 #if defined (NS_IMPL_COCOA)
2080               (typeUTF16ExternalRepresentation
2081                == [returnDescriptor descriptorType]) ||
2082 #endif
2083               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2084               (typeCString == [returnDescriptor descriptorType]))
2085             {
2086               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2087               if (desc)
2088                 *result = build_string([[desc stringValue] UTF8String]);
2089             }
2090           else
2091             {
2092               /* use typeUTF16ExternalRepresentation? */
2093               // coerce the result to the appropriate ObjC type
2094               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2095               if (desc)
2096                 *result = make_number([desc int32Value]);
2097             }
2098         }
2099     }
2100   else
2101     {
2102       // no script result, return error
2103       return 1;
2104     }
2105   return 0;
2108 /* Helper function called from sendEvent to run applescript
2109    from within the main event loop.  */
2111 void
2112 ns_run_ascript (void)
2114   if (! NILP (as_script))
2115     as_status = ns_do_applescript (as_script, as_result);
2116   as_script = Qnil;
2119 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2120        doc: /* Execute AppleScript SCRIPT and return the result.
2121 If compilation and execution are successful, the resulting script value
2122 is returned as a string, a number or, in the case of other constructs, t.
2123 In case the execution fails, an error is signaled. */)
2124      (Lisp_Object script)
2126   Lisp_Object result;
2127   int status;
2128   NSEvent *nxev;
2130   CHECK_STRING (script);
2131   check_window_system (NULL);
2133   block_input ();
2135   as_script = script;
2136   as_result = &result;
2138   /* executing apple script requires the event loop to run, otherwise
2139      errors aren't returned and executeAndReturnError hangs forever.
2140      Post an event that runs applescript and then start the event loop.
2141      The event loop is exited when the script is done.  */
2142   nxev = [NSEvent otherEventWithType: NSApplicationDefined
2143                             location: NSMakePoint (0, 0)
2144                        modifierFlags: 0
2145                            timestamp: 0
2146                         windowNumber: [[NSApp mainWindow] windowNumber]
2147                              context: [NSApp context]
2148                              subtype: 0
2149                                data1: 0
2150                                data2: NSAPP_DATA2_RUNASSCRIPT];
2152   [NSApp postEvent: nxev atStart: NO];
2154   // If there are other events, the event loop may exit.  Keep running
2155   // until the script has been handled.  */
2156   while (! NILP (as_script))
2157     [NSApp run];
2159   status = as_status;
2160   as_status = 0;
2161   as_result = 0;
2162   unblock_input ();
2163   if (status == 0)
2164     return result;
2165   else if (!STRINGP (result))
2166     error ("AppleScript error %d", status);
2167   else
2168     error ("%s", SSDATA (result));
2170 #endif
2174 /* ==========================================================================
2176     Miscellaneous functions not called through hooks
2178    ========================================================================== */
2180 /* called from frame.c */
2181 struct ns_display_info *
2182 check_x_display_info (Lisp_Object frame)
2184   return check_ns_display_info (frame);
2188 void
2189 x_set_scroll_bar_default_width (struct frame *f)
2191   int wid = FRAME_COLUMN_WIDTH (f);
2192   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2193   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2194                                       wid - 1) / wid;
2198 extern const char *x_get_string_resource (XrmDatabase, char *, char *);
2201 /* terms impl this instead of x-get-resource directly */
2202 const char *
2203 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2205   /* remove appname prefix; TODO: allow for !="Emacs" */
2206   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2207   const char *res;
2208   check_window_system (NULL);
2210   if (inhibit_x_resources)
2211     /* --quick was passed, so this is a no-op.  */
2212     return NULL;
2214   res = ns_get_defaults_value (toCheck);
2215   return !res ? NULL :
2216       (!c_strncasecmp (res, "YES", 3) ? "true" :
2217           (!c_strncasecmp (res, "NO", 2) ? "false" : res));
2221 Lisp_Object
2222 x_get_focus_frame (struct frame *frame)
2224   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2225   Lisp_Object nsfocus;
2227   if (!dpyinfo->x_focus_frame)
2228     return Qnil;
2230   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2231   return nsfocus;
2236 x_pixel_width (struct frame *f)
2238   return FRAME_PIXEL_WIDTH (f);
2243 x_pixel_height (struct frame *f)
2245   return FRAME_PIXEL_HEIGHT (f);
2249 void
2250 x_sync (struct frame *f)
2252   /* XXX Not implemented XXX */
2253   return;
2258 /* ==========================================================================
2260     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2262    ========================================================================== */
2265 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2266        doc: /* Internal function called by `color-defined-p', which see.
2267 \(Note that the Nextstep version of this function ignores FRAME.)  */)
2268      (Lisp_Object color, Lisp_Object frame)
2270   NSColor * col;
2271   check_window_system (NULL);
2272   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2276 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2277        doc: /* Internal function called by `color-values', which see.  */)
2278      (Lisp_Object color, Lisp_Object frame)
2280   NSColor * col;
2281   EmacsCGFloat red, green, blue, alpha;
2283   check_window_system (NULL);
2284   CHECK_STRING (color);
2286   if (ns_lisp_to_color (color, &col))
2287     return Qnil;
2289   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2290         getRed: &red green: &green blue: &blue alpha: &alpha];
2291   return list3i (lrint (red * 65280), lrint (green * 65280),
2292                  lrint (blue * 65280));
2296 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2297        doc: /* Internal function called by `display-color-p', which see.  */)
2298      (Lisp_Object terminal)
2300   NSWindowDepth depth;
2301   NSString *colorSpace;
2303   check_ns_display_info (terminal);
2304   depth = [[[NSScreen screens] objectAtIndex:0] depth];
2305   colorSpace = NSColorSpaceFromDepth (depth);
2307   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2308          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2309       ? Qnil : Qt;
2313 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p, Sx_display_grayscale_p,
2314        0, 1, 0,
2315        doc: /* Return t if the Nextstep display supports shades of gray.
2316 Note that color displays do support shades of gray.
2317 The optional argument TERMINAL specifies which display to ask about.
2318 TERMINAL should be a terminal object, a frame or a display name (a string).
2319 If omitted or nil, that stands for the selected frame's display.  */)
2320   (Lisp_Object terminal)
2322   NSWindowDepth depth;
2324   check_ns_display_info (terminal);
2325   depth = [[[NSScreen screens] objectAtIndex:0] depth];
2327   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2331 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2332        0, 1, 0,
2333        doc: /* Return the width in pixels of the Nextstep display TERMINAL.
2334 The optional argument TERMINAL specifies which display to ask about.
2335 TERMINAL should be a terminal object, a frame or a display name (a string).
2336 If omitted or nil, that stands for the selected frame's display.
2338 On \"multi-monitor\" setups this refers to the pixel width for all
2339 physical monitors associated with TERMINAL.  To get information for
2340 each physical monitor, use `display-monitor-attributes-list'.  */)
2341   (Lisp_Object terminal)
2343   struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2345   return make_number (x_display_pixel_width (dpyinfo));
2349 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2350        Sx_display_pixel_height, 0, 1, 0,
2351        doc: /* Return the height in pixels of the Nextstep display TERMINAL.
2352 The optional argument TERMINAL specifies which display to ask about.
2353 TERMINAL should be a terminal object, a frame or a display name (a string).
2354 If omitted or nil, that stands for the selected frame's display.
2356 On \"multi-monitor\" setups this refers to the pixel height for all
2357 physical monitors associated with TERMINAL.  To get information for
2358 each physical monitor, use `display-monitor-attributes-list'.  */)
2359   (Lisp_Object terminal)
2361   struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2363   return make_number (x_display_pixel_height (dpyinfo));
2366 #ifdef NS_IMPL_COCOA
2367 /* Returns the name for the screen that DICT came from, or NULL.
2368    Caller must free return value.
2371 static char *
2372 ns_screen_name (CGDirectDisplayID did)
2374   char *name = NULL;
2375   NSDictionary *info = (NSDictionary *)
2376     IODisplayCreateInfoDictionary (CGDisplayIOServicePort (did),
2377                                    kIODisplayOnlyPreferredName);
2378   NSDictionary *names
2379     = [info objectForKey:
2380               [NSString stringWithUTF8String:kDisplayProductName]];
2382   if ([names count] > 0) {
2383     NSString *n = [names objectForKey: [[names allKeys] objectAtIndex:0]];
2384     if (n != nil)
2385       name = xstrdup ([n UTF8String]);
2386   }
2388   [info release];
2389   return name;
2391 #endif
2393 static Lisp_Object
2394 ns_make_monitor_attribute_list (struct MonitorInfo *monitors,
2395                                 int n_monitors,
2396                                 int primary_monitor,
2397                                 const char *source)
2399   Lisp_Object monitor_frames = Fmake_vector (make_number (n_monitors), Qnil);
2400   Lisp_Object frame, rest;
2401   NSArray *screens = [NSScreen screens];
2402   int i;
2404   FOR_EACH_FRAME (rest, frame)
2405     {
2406       struct frame *f = XFRAME (frame);
2408       if (FRAME_NS_P (f))
2409         {
2410           NSView *view = FRAME_NS_VIEW (f);
2411           NSScreen *screen = [[view window] screen];
2412           NSUInteger k;
2414           i = -1;
2415           for (k = 0; i == -1 && k < [screens count]; ++k)
2416             {
2417               if ([screens objectAtIndex: k] == screen)
2418                 i = (int)k;
2419             }
2421           if (i > -1)
2422             ASET (monitor_frames, i, Fcons (frame, AREF (monitor_frames, i)));
2423         }
2424     }
2426   return make_monitor_attribute_list (monitors, n_monitors, primary_monitor,
2427                                       monitor_frames, source);
2430 DEFUN ("ns-display-monitor-attributes-list",
2431        Fns_display_monitor_attributes_list,
2432        Sns_display_monitor_attributes_list,
2433        0, 1, 0,
2434        doc: /* Return a list of physical monitor attributes on the X display TERMINAL.
2436 The optional argument TERMINAL specifies which display to ask about.
2437 TERMINAL should be a terminal object, a frame or a display name (a string).
2438 If omitted or nil, that stands for the selected frame's display.
2440 In addition to the standard attribute keys listed in
2441 `display-monitor-attributes-list', the following keys are contained in
2442 the attributes:
2444  source -- String describing the source from which multi-monitor
2445            information is obtained, \"NS\" is always the source."
2447 Internal use only, use `display-monitor-attributes-list' instead.  */)
2448   (Lisp_Object terminal)
2450   struct terminal *term = get_terminal (terminal, 1);
2451   NSArray *screens;
2452   NSUInteger i, n_monitors;
2453   struct MonitorInfo *monitors;
2454   Lisp_Object attributes_list = Qnil;
2455   CGFloat primary_display_height = 0;
2457   if (term->type != output_ns)
2458     return Qnil;
2460   screens = [NSScreen screens];
2461   n_monitors = [screens count];
2462   if (n_monitors == 0)
2463     return Qnil;
2465   monitors = (struct MonitorInfo *) xzalloc (n_monitors * sizeof (*monitors));
2467   for (i = 0; i < [screens count]; ++i)
2468     {
2469       NSScreen *s = [screens objectAtIndex:i];
2470       struct MonitorInfo *m = &monitors[i];
2471       NSRect fr = [s frame];
2472       NSRect vfr = [s visibleFrame];
2473       short y, vy;
2475 #ifdef NS_IMPL_COCOA
2476       NSDictionary *dict = [s deviceDescription];
2477       NSNumber *nid = [dict objectForKey:@"NSScreenNumber"];
2478       CGDirectDisplayID did = [nid unsignedIntValue];
2479 #endif
2480       if (i == 0)
2481         {
2482           primary_display_height = fr.size.height;
2483           y = (short) fr.origin.y;
2484           vy = (short) vfr.origin.y;
2485         }
2486       else
2487         {
2488           // Flip y coordinate as NS has y starting from the bottom.
2489           y = (short) (primary_display_height - fr.size.height - fr.origin.y);
2490           vy = (short) (primary_display_height -
2491                         vfr.size.height - vfr.origin.y);
2492         }
2494       m->geom.x = (short) fr.origin.x;
2495       m->geom.y = y;
2496       m->geom.width = (unsigned short) fr.size.width;
2497       m->geom.height = (unsigned short) fr.size.height;
2499       m->work.x = (short) vfr.origin.x;
2500       // y is flipped on NS, so vy - y are pixels missing at the bottom,
2501       // and fr.size.height - vfr.size.height are pixels missing in total.
2502       // Pixels missing at top are
2503       // fr.size.height - vfr.size.height - vy + y.
2504       // work.y is then pixels missing at top + y.
2505       m->work.y = (short) (fr.size.height - vfr.size.height) - vy + y + y;
2506       m->work.width = (unsigned short) vfr.size.width;
2507       m->work.height = (unsigned short) vfr.size.height;
2509 #ifdef NS_IMPL_COCOA
2510       m->name = ns_screen_name (did);
2512       {
2513         CGSize mms = CGDisplayScreenSize (did);
2514         m->mm_width = (int) mms.width;
2515         m->mm_height = (int) mms.height;
2516       }
2518 #else
2519       // Assume 92 dpi as x-display-mm-height/x-display-mm-width does.
2520       m->mm_width = (int) (25.4 * fr.size.width / 92.0);
2521       m->mm_height = (int) (25.4 * fr.size.height / 92.0);
2522 #endif
2523     }
2525   // Primary monitor is always first for NS.
2526   attributes_list = ns_make_monitor_attribute_list (monitors, n_monitors,
2527                                                     0, "NS");
2529   free_monitors (monitors, n_monitors);
2530   return attributes_list;
2534 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2535        0, 1, 0,
2536        doc: /* Return the number of bitplanes of the Nextstep display TERMINAL.
2537 The optional argument TERMINAL specifies which display to ask about.
2538 TERMINAL should be a terminal object, a frame or a display name (a string).
2539 If omitted or nil, that stands for the selected frame's display.  */)
2540   (Lisp_Object terminal)
2542   check_ns_display_info (terminal);
2543   return make_number
2544     (NSBitsPerPixelFromDepth ([[[NSScreen screens] objectAtIndex:0] depth]));
2548 DEFUN ("x-display-color-cells", Fx_display_color_cells, Sx_display_color_cells,
2549        0, 1, 0,
2550        doc: /* Returns the number of color cells of the Nextstep display TERMINAL.
2551 The optional argument TERMINAL specifies which display to ask about.
2552 TERMINAL should be a terminal object, a frame or a display name (a string).
2553 If omitted or nil, that stands for the selected frame's display.  */)
2554   (Lisp_Object terminal)
2556   struct ns_display_info *dpyinfo = check_ns_display_info (terminal);
2557   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2558   return make_number (1 << min (dpyinfo->n_planes, 24));
2562 /* Unused dummy def needed for compatibility. */
2563 Lisp_Object tip_frame;
2565 /* TODO: move to xdisp or similar */
2566 static void
2567 compute_tip_xy (struct frame *f,
2568                 Lisp_Object parms,
2569                 Lisp_Object dx,
2570                 Lisp_Object dy,
2571                 int width,
2572                 int height,
2573                 int *root_x,
2574                 int *root_y)
2576   Lisp_Object left, top;
2577   EmacsView *view = FRAME_NS_VIEW (f);
2578   NSPoint pt;
2580   /* Start with user-specified or mouse position.  */
2581   left = Fcdr (Fassq (Qleft, parms));
2582   top = Fcdr (Fassq (Qtop, parms));
2584   if (!INTEGERP (left) || !INTEGERP (top))
2585     {
2586       pt = last_mouse_motion_position;
2587       /* Convert to screen coordinates */
2588       pt = [view convertPoint: pt toView: nil];
2589       pt = [[view window] convertBaseToScreen: pt];
2590     }
2591   else
2592     {
2593       /* Absolute coordinates.  */
2594       pt.x = XINT (left);
2595       pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2596         - height;
2597     }
2599   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2600   if (INTEGERP (left))
2601     *root_x = pt.x;
2602   else if (pt.x + XINT (dx) <= 0)
2603     *root_x = 0; /* Can happen for negative dx */
2604   else if (pt.x + XINT (dx) + width
2605            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2606     /* It fits to the right of the pointer.  */
2607     *root_x = pt.x + XINT (dx);
2608   else if (width + XINT (dx) <= pt.x)
2609     /* It fits to the left of the pointer.  */
2610     *root_x = pt.x - width - XINT (dx);
2611   else
2612     /* Put it left justified on the screen -- it ought to fit that way.  */
2613     *root_x = 0;
2615   if (INTEGERP (top))
2616     *root_y = pt.y;
2617   else if (pt.y - XINT (dy) - height >= 0)
2618     /* It fits below the pointer.  */
2619     *root_y = pt.y - height - XINT (dy);
2620   else if (pt.y + XINT (dy) + height
2621            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2622     /* It fits above the pointer */
2623       *root_y = pt.y + XINT (dy);
2624   else
2625     /* Put it on the top.  */
2626     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2630 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2631        doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2632 A tooltip window is a small window displaying a string.
2634 This is an internal function; Lisp code should call `tooltip-show'.
2636 FRAME nil or omitted means use the selected frame.
2638 PARMS is an optional list of frame parameters which can be used to
2639 change the tooltip's appearance.
2641 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2642 means use the default timeout of 5 seconds.
2644 If the list of frame parameters PARMS contains a `left' parameter,
2645 the tooltip is displayed at that x-position.  Otherwise it is
2646 displayed at the mouse position, with offset DX added (default is 5 if
2647 DX isn't specified).  Likewise for the y-position; if a `top' frame
2648 parameter is specified, it determines the y-position of the tooltip
2649 window, otherwise it is displayed at the mouse position, with offset
2650 DY added (default is -10).
2652 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2653 Text larger than the specified size is clipped.  */)
2654      (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2656   int root_x, root_y;
2657   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2658   ptrdiff_t count = SPECPDL_INDEX ();
2659   struct frame *f;
2660   char *str;
2661   NSSize size;
2663   specbind (Qinhibit_redisplay, Qt);
2665   GCPRO4 (string, parms, frame, timeout);
2667   CHECK_STRING (string);
2668   str = SSDATA (string);
2669   f = decode_window_system_frame (frame);
2670   if (NILP (timeout))
2671     timeout = make_number (5);
2672   else
2673     CHECK_NATNUM (timeout);
2675   if (NILP (dx))
2676     dx = make_number (5);
2677   else
2678     CHECK_NUMBER (dx);
2680   if (NILP (dy))
2681     dy = make_number (-10);
2682   else
2683     CHECK_NUMBER (dy);
2685   block_input ();
2686   if (ns_tooltip == nil)
2687     ns_tooltip = [[EmacsTooltip alloc] init];
2688   else
2689     Fx_hide_tip ();
2691   [ns_tooltip setText: str];
2692   size = [ns_tooltip frame].size;
2694   /* Move the tooltip window where the mouse pointer is.  Resize and
2695      show it.  */
2696   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2697                   &root_x, &root_y);
2699   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2700   unblock_input ();
2702   UNGCPRO;
2703   return unbind_to (count, Qnil);
2707 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2708        doc: /* Hide the current tooltip window, if there is any.
2709 Value is t if tooltip was open, nil otherwise.  */)
2710      (void)
2712   if (ns_tooltip == nil || ![ns_tooltip isActive])
2713     return Qnil;
2714   [ns_tooltip hide];
2715   return Qt;
2719 /* ==========================================================================
2721     Class implementations
2723    ========================================================================== */
2726   Handle arrow/function/control keys and copy/paste/cut in file dialogs.
2727   Return YES if handled, NO if not.
2728  */
2729 static BOOL
2730 handlePanelKeys (NSSavePanel *panel, NSEvent *theEvent)
2732   NSString *s;
2733   int i;
2734   BOOL ret = NO;
2736   if ([theEvent type] != NSKeyDown) return NO;
2737   s = [theEvent characters];
2739   for (i = 0; i < [s length]; ++i)
2740     {
2741       int ch = (int) [s characterAtIndex: i];
2742       switch (ch)
2743         {
2744         case NSHomeFunctionKey:
2745         case NSDownArrowFunctionKey:
2746         case NSUpArrowFunctionKey:
2747         case NSLeftArrowFunctionKey:
2748         case NSRightArrowFunctionKey:
2749         case NSPageUpFunctionKey:
2750         case NSPageDownFunctionKey:
2751         case NSEndFunctionKey:
2752           /* Don't send command modified keys, as those are handled in the
2753              performKeyEquivalent method of the super class.
2754           */
2755           if (! ([theEvent modifierFlags] & NSCommandKeyMask))
2756             {
2757               [panel sendEvent: theEvent];
2758               ret = YES;
2759             }
2760           break;
2761           /* As we don't have the standard key commands for
2762              copy/paste/cut/select-all in our edit menu, we must handle
2763              them here.  TODO: handle Emacs key bindings for copy/cut/select-all
2764              here, paste works, because we have that in our Edit menu.
2765              I.e. refactor out code in nsterm.m, keyDown: to figure out the
2766              correct modifier.
2767           */
2768         case 'x': // Cut
2769         case 'c': // Copy
2770         case 'v': // Paste
2771         case 'a': // Select all
2772           if ([theEvent modifierFlags] & NSCommandKeyMask)
2773             {
2774               [NSApp sendAction:
2775                        (ch == 'x'
2776                         ? @selector(cut:)
2777                         : (ch == 'c'
2778                            ? @selector(copy:)
2779                            : (ch == 'v'
2780                               ? @selector(paste:)
2781                               : @selector(selectAll:))))
2782                              to:nil from:panel];
2783               ret = YES;
2784             }
2785         default:
2786           // Send all control keys, as the text field supports C-a, C-f, C-e
2787           // C-b and more.
2788           if ([theEvent modifierFlags] & NSControlKeyMask)
2789             {
2790               [panel sendEvent: theEvent];
2791               ret = YES;
2792             }
2793           break;
2794         }
2795     }
2798   return ret;
2801 @implementation EmacsSavePanel
2802 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
2804   BOOL ret = handlePanelKeys (self, theEvent);
2805   if (! ret)
2806     ret = [super performKeyEquivalent:theEvent];
2807   return ret;
2809 @end
2812 @implementation EmacsOpenPanel
2813 - (BOOL)performKeyEquivalent:(NSEvent *)theEvent
2815   // NSOpenPanel inherits NSSavePanel, so passing self is OK.
2816   BOOL ret = handlePanelKeys (self, theEvent);
2817   if (! ret)
2818     ret = [super performKeyEquivalent:theEvent];
2819   return ret;
2821 @end
2824 @implementation EmacsFileDelegate
2825 /* --------------------------------------------------------------------------
2826    Delegate methods for Open/Save panels
2827    -------------------------------------------------------------------------- */
2828 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2830   return YES;
2832 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2834   return YES;
2836 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2837           confirmed: (BOOL)okFlag
2839   return filename;
2841 @end
2843 #endif
2846 /* ==========================================================================
2848     Lisp interface declaration
2850    ========================================================================== */
2853 void
2854 syms_of_nsfns (void)
2856   Qfontsize = intern_c_string ("fontsize");
2857   staticpro (&Qfontsize);
2859   DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2860                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2861 If the title of a frame matches REGEXP, then IMAGE.tiff is
2862 selected as the image of the icon representing the frame when it's
2863 miniaturized.  If an element is t, then Emacs tries to select an icon
2864 based on the filetype of the visited file.
2866 The images have to be installed in a folder called English.lproj in the
2867 Emacs folder.  You have to restart Emacs after installing new icons.
2869 Example: Install an icon Gnus.tiff and execute the following code
2871   (setq ns-icon-type-alist
2872         (append ns-icon-type-alist
2873                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2874                    . \"Gnus\"))))
2876 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2877 be used as the image of the icon representing the frame.  */);
2878   Vns_icon_type_alist = list1 (Qt);
2880   DEFVAR_LISP ("ns-version-string", Vns_version_string,
2881                doc: /* Toolkit version for NS Windowing.  */);
2882   Vns_version_string = ns_appkit_version_str ();
2884   defsubr (&Sns_read_file_name);
2885   defsubr (&Sns_get_resource);
2886   defsubr (&Sns_set_resource);
2887   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2888   defsubr (&Sx_display_grayscale_p);
2889   defsubr (&Sns_font_name);
2890   defsubr (&Sns_list_colors);
2891 #ifdef NS_IMPL_COCOA
2892   defsubr (&Sns_do_applescript);
2893 #endif
2894   defsubr (&Sxw_color_defined_p);
2895   defsubr (&Sxw_color_values);
2896   defsubr (&Sx_server_max_request_size);
2897   defsubr (&Sx_server_vendor);
2898   defsubr (&Sx_server_version);
2899   defsubr (&Sx_display_pixel_width);
2900   defsubr (&Sx_display_pixel_height);
2901   defsubr (&Sns_display_monitor_attributes_list);
2902   defsubr (&Sx_display_mm_width);
2903   defsubr (&Sx_display_mm_height);
2904   defsubr (&Sx_display_screens);
2905   defsubr (&Sx_display_planes);
2906   defsubr (&Sx_display_color_cells);
2907   defsubr (&Sx_display_visual_class);
2908   defsubr (&Sx_display_backing_store);
2909   defsubr (&Sx_display_save_under);
2910   defsubr (&Sx_create_frame);
2911   defsubr (&Sx_open_connection);
2912   defsubr (&Sx_close_connection);
2913   defsubr (&Sx_display_list);
2915   defsubr (&Sns_hide_others);
2916   defsubr (&Sns_hide_emacs);
2917   defsubr (&Sns_emacs_info_panel);
2918   defsubr (&Sns_list_services);
2919   defsubr (&Sns_perform_service);
2920   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2921   defsubr (&Sx_focus_frame);
2922   defsubr (&Sns_popup_font_panel);
2923   defsubr (&Sns_popup_color_panel);
2925   defsubr (&Sx_show_tip);
2926   defsubr (&Sx_hide_tip);
2928   as_status = 0;
2929   as_script = Qnil;
2930   as_result = 0;