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