* descr-text.el (describe-char): Put the overlays over the
[emacs.git] / src / nsfns.m
blob0b639d6269c190b1b90e176124e3103cc8e407a3
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;
87 Lisp_Object Qbuffered;
88 Lisp_Object Qfontsize;
90 /* hack for OS X file panels */
91 char panelOK = 0;
93 EmacsTooltip *ns_tooltip;
95 /* Need forward declaration here to preserve organizational integrity of file */
96 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
98 extern BOOL ns_in_resize;
100 /* Static variables to handle applescript execution.  */
101 static Lisp_Object as_script, *as_result;
102 static int as_status;
104 #ifdef GLYPH_DEBUG
105 static ptrdiff_t image_cache_refcount;
106 #endif
108 /* ==========================================================================
110     Internal utility functions
112    ========================================================================== */
115 void
116 check_ns (void)
118  if (NSApp == nil)
119    error ("OpenStep is not in use or not initialized");
123 /* Nonzero if we can use mouse menus. */
125 have_menus_p (void)
127   return NSApp != nil;
131 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
132    and checking validity for NS.  */
133 static FRAME_PTR
134 check_ns_frame (Lisp_Object frame)
136   FRAME_PTR f;
138   if (NILP (frame))
139       f = SELECTED_FRAME ();
140   else
141     {
142       CHECK_LIVE_FRAME (frame);
143       f = XFRAME (frame);
144     }
145   if (! FRAME_NS_P (f))
146     error ("non-Nextstep frame used");
147   return f;
151 /* Let the user specify an Nextstep display with a frame.
152    nil stands for the selected frame--or, if that is not an Nextstep frame,
153    the first Nextstep display on the list.  */
154 static struct ns_display_info *
155 check_ns_display_info (Lisp_Object frame)
157   if (NILP (frame))
158     {
159       struct frame *f = SELECTED_FRAME ();
160       if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
161         return FRAME_NS_DISPLAY_INFO (f);
162       else if (x_display_list != 0)
163         return x_display_list;
164       else
165         error ("Nextstep windows are not in use or not initialized");
166     }
167   else if (INTEGERP (frame))
168     {
169       struct terminal *t = get_terminal (frame, 1);
171       if (t->type != output_ns)
172         error ("Terminal %"pI"d is not a Nextstep display", XINT (frame));
174       return t->display_info.ns;
175     }
176   else if (STRINGP (frame))
177     return ns_display_info_for_name (frame);
178   else
179     {
180       FRAME_PTR f;
182       CHECK_LIVE_FRAME (frame);
183       f = XFRAME (frame);
184       if (! FRAME_NS_P (f))
185         error ("non-Nextstep frame used");
186       return FRAME_NS_DISPLAY_INFO (f);
187     }
188   return NULL;  /* shut compiler up */
192 static id
193 ns_get_window (Lisp_Object maybeFrame)
195   id view =nil, window =nil;
197   if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
198     maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
200   if (!NILP (maybeFrame))
201     view = FRAME_NS_VIEW (XFRAME (maybeFrame));
202   if (view) window =[view window];
204   return window;
208 static NSScreen *
209 ns_get_screen (Lisp_Object screen)
211   struct frame *f;
212   struct terminal *terminal;
214   if (EQ (Qt, screen)) /* not documented */
215     return [NSScreen mainScreen];
217   terminal = get_terminal (screen, 1);
218   if (terminal->type != output_ns)
219     return NULL;
221   if (NILP (screen))
222     f = SELECTED_FRAME ();
223   else if (FRAMEP (screen))
224     f = XFRAME (screen);
225   else
226     {
227       struct ns_display_info *dpyinfo = terminal->display_info.ns;
228       f = dpyinfo->x_focus_frame
229         ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
230     }
232   return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
233           : NULL);
237 /* Return the X display structure for the display named NAME.
238    Open a new connection if necessary.  */
239 struct ns_display_info *
240 ns_display_info_for_name (Lisp_Object name)
242   Lisp_Object names;
243   struct ns_display_info *dpyinfo;
245   CHECK_STRING (name);
247   for (dpyinfo = x_display_list, names = ns_display_name_list;
248        dpyinfo;
249        dpyinfo = dpyinfo->next, names = XCDR (names))
250     {
251       Lisp_Object tem;
252       tem = Fstring_equal (XCAR (XCAR (names)), name);
253       if (!NILP (tem))
254         return dpyinfo;
255     }
257   error ("Emacs for OpenStep does not yet support multi-display.");
259   Fx_open_connection (name, Qnil, Qnil);
260   dpyinfo = x_display_list;
262   if (dpyinfo == 0)
263     error ("OpenStep on %s not responding.\n", SDATA (name));
265   return dpyinfo;
269 static Lisp_Object
270 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
271 /* --------------------------------------------------------------------------
272    Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
273    -------------------------------------------------------------------------- */
275   int i, count;
276   NSMenuItem *item;
277   const char *name;
278   Lisp_Object nameStr;
279   unsigned short key;
280   NSString *keys;
281   Lisp_Object res;
283   count = [menu numberOfItems];
284   for (i = 0; i<count; i++)
285     {
286       item = [menu itemAtIndex: i];
287       name = [[item title] UTF8String];
288       if (!name) continue;
290       nameStr = build_string (name);
292       if ([item hasSubmenu])
293         {
294           old = interpret_services_menu ([item submenu],
295                                         Fcons (nameStr, prefix), old);
296         }
297       else
298         {
299           keys = [item keyEquivalent];
300           if (keys && [keys length] )
301             {
302               key = [keys characterAtIndex: 0];
303               res = make_number (key|super_modifier);
304             }
305           else
306             {
307               res = Qundefined;
308             }
309           old = Fcons (Fcons (res,
310                             Freverse (Fcons (nameStr,
311                                            prefix))),
312                     old);
313         }
314     }
315   return old;
320 /* ==========================================================================
322     Frame parameter setters
324    ========================================================================== */
327 static void
328 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
330   NSColor *col;
331   CGFloat r, g, b, alpha;
333   if (ns_lisp_to_color (arg, &col))
334     {
335       store_frame_param (f, Qforeground_color, oldval);
336       error ("Unknown color");
337     }
339   [col retain];
340   [f->output_data.ns->foreground_color release];
341   f->output_data.ns->foreground_color = col;
343   [col getRed: &r green: &g blue: &b alpha: &alpha];
344   FRAME_FOREGROUND_PIXEL (f) =
345     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
347   if (FRAME_NS_VIEW (f))
348     {
349       update_face_from_frame_parameter (f, Qforeground_color, arg);
350       /*recompute_basic_faces (f); */
351       if (FRAME_VISIBLE_P (f))
352         redraw_frame (f);
353     }
357 static void
358 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
360   struct face *face;
361   NSColor *col;
362   NSView *view = FRAME_NS_VIEW (f);
363   CGFloat r, g, b, alpha;
365   if (ns_lisp_to_color (arg, &col))
366     {
367       store_frame_param (f, Qbackground_color, oldval);
368       error ("Unknown color");
369     }
371   /* clear the frame; in some instances the NS-internal GC appears not to
372      update, or it does update and cannot clear old text properly */
373   if (FRAME_VISIBLE_P (f))
374     ns_clear_frame (f);
376   [col retain];
377   [f->output_data.ns->background_color release];
378   f->output_data.ns->background_color = col;
380   [col getRed: &r green: &g blue: &b alpha: &alpha];
381   FRAME_BACKGROUND_PIXEL (f) =
382     ARGB_TO_ULONG ((int)(alpha*0xff), (int)(r*0xff), (int)(g*0xff), (int)(b*0xff));
384   if (view != nil)
385     {
386       [[view window] setBackgroundColor: col];
388       if (alpha != 1.0)
389           [[view window] setOpaque: NO];
390       else
391           [[view window] setOpaque: YES];
393       face = FRAME_DEFAULT_FACE (f);
394       if (face)
395         {
396           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
397           face->background = ns_index_color
398             ([col colorWithAlphaComponent: alpha], f);
400           update_face_from_frame_parameter (f, Qbackground_color, arg);
401         }
403       if (FRAME_VISIBLE_P (f))
404         redraw_frame (f);
405     }
409 static void
410 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
412   NSColor *col;
414   if (ns_lisp_to_color (arg, &col))
415     {
416       store_frame_param (f, Qcursor_color, oldval);
417       error ("Unknown color");
418     }
420   [FRAME_CURSOR_COLOR (f) release];
421   FRAME_CURSOR_COLOR (f) = [col retain];
423   if (FRAME_VISIBLE_P (f))
424     {
425       x_update_cursor (f, 0);
426       x_update_cursor (f, 1);
427     }
428   update_face_from_frame_parameter (f, Qcursor_color, arg);
432 static void
433 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
435   NSView *view = FRAME_NS_VIEW (f);
436   NSTRACE (x_set_icon_name);
438   if (ns_in_resize)
439     return;
441   /* see if it's changed */
442   if (STRINGP (arg))
443     {
444       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
445         return;
446     }
447   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
448     return;
450   FSET (f, icon_name, arg);
452   if (NILP (arg))
453     {
454       if (!NILP (f->title))
455         arg = f->title;
456       else
457         /* explicit name and no icon-name -> explicit_name */
458         if (f->explicit_name)
459           arg = f->name;
460         else
461           {
462             /* no explicit name and no icon-name ->
463                name has to be rebuild from icon_title_format */
464             windows_or_buffers_changed++;
465             return;
466           }
467     }
469   /* Don't change the name if it's already NAME.  */
470   if ([[view window] miniwindowTitle] &&
471       ([[[view window] miniwindowTitle]
472              isEqualToString: [NSString stringWithUTF8String:
473                                            SSDATA (arg)]]))
474     return;
476   [[view window] setMiniwindowTitle:
477         [NSString stringWithUTF8String: SSDATA (arg)]];
480 static void
481 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
483   struct gcpro gcpro1;
484   Lisp_Object encoded_name, encoded_icon_name;
485   NSString *str;
486   NSView *view = FRAME_NS_VIEW (f);
488   GCPRO1 (name);
489   encoded_name = ENCODE_UTF_8 (name);
490   UNGCPRO;
492   str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
494   /* Don't change the name if it's already NAME.  */
495   if (! [[[view window] title] isEqualToString: str])
496     [[view window] setTitle: str];
498   if (!STRINGP (f->icon_name))
499     encoded_icon_name = encoded_name;
500   else
501     encoded_icon_name = ENCODE_UTF_8 (f->icon_name);
503   str = [NSString stringWithUTF8String: SSDATA (encoded_icon_name)];
505   if ([[view window] miniwindowTitle] &&
506       ! [[[view window] miniwindowTitle] isEqualToString: str])
507     [[view window] setMiniwindowTitle: str];
511 static void
512 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
514   NSTRACE (ns_set_name);
516   if (ns_in_resize)
517     return;
519   /* Make sure that requests from lisp code override requests from
520      Emacs redisplay code.  */
521   if (explicit)
522     {
523       /* If we're switching from explicit to implicit, we had better
524          update the mode lines and thereby update the title.  */
525       if (f->explicit_name && NILP (name))
526         update_mode_lines = 1;
528       f->explicit_name = ! NILP (name);
529     }
530   else if (f->explicit_name)
531     return;
533   if (NILP (name))
534     name = build_string([ns_app_name UTF8String]);
535   else
536     CHECK_STRING (name);
538   /* Don't change the name if it's already NAME.  */
539   if (! NILP (Fstring_equal (name, f->name)))
540     return;
542   FSET (f, name, name);
544   /* title overrides explicit name */
545   if (! NILP (f->title))
546     name = f->title;
548   ns_set_name_internal (f, name);
552 /* This function should be called when the user's lisp code has
553    specified a name for the frame; the name will override any set by the
554    redisplay code.  */
555 static void
556 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
558   NSTRACE (x_explicitly_set_name);
559   ns_set_name (f, arg, 1);
563 /* This function should be called by Emacs redisplay code to set the
564    name; names set this way will never override names set by the user's
565    lisp code.  */
566 void
567 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
569   NSTRACE (x_implicitly_set_name);
571   /* Deal with NS specific format t.  */
572   if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
573                          || EQ (Vframe_title_format, Qt)))
574     ns_set_name_as_filename (f);
575   else
576     ns_set_name (f, arg, 0);
580 /* Change the title of frame F to NAME.
581    If NAME is nil, use the frame name as the title.  */
583 static void
584 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
586   NSTRACE (x_set_title);
587   /* Don't change the title if it's already NAME.  */
588   if (EQ (name, f->title))
589     return;
591   update_mode_lines = 1;
593   FSET (f, title, name);
595   if (NILP (name))
596     name = f->name;
597   else
598     CHECK_STRING (name);
600   ns_set_name_internal (f, name);
604 void
605 ns_set_name_as_filename (struct frame *f)
607   NSView *view;
608   Lisp_Object name, filename;
609   Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
610   const char *title;
611   NSAutoreleasePool *pool;
612   struct gcpro gcpro1;
613   Lisp_Object encoded_name, encoded_filename;
614   NSString *str;
615   NSTRACE (ns_set_name_as_filename);
617   if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
618     return;
620   BLOCK_INPUT;
621   pool = [[NSAutoreleasePool alloc] init];
622   filename = BVAR (XBUFFER (buf), filename);
623   name = BVAR (XBUFFER (buf), name);
625   if (NILP (name))
626     {
627       if (! NILP (filename))
628         name = Ffile_name_nondirectory (filename);
629       else
630         name = build_string ([ns_app_name UTF8String]);
631     }
633   GCPRO1 (name);
634   encoded_name = ENCODE_UTF_8 (name);
635   UNGCPRO;
637   view = FRAME_NS_VIEW (f);
639   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
640                                 : [[[view window] title] UTF8String];
642   if (title && (! strcmp (title, SSDATA (encoded_name))))
643     {
644       [pool release];
645       UNBLOCK_INPUT;
646       return;
647     }
649   str = [NSString stringWithUTF8String: SSDATA (encoded_name)];
650   if (str == nil) str = @"Bad coding";
652   if (FRAME_ICONIFIED_P (f))
653     [[view window] setMiniwindowTitle: str];
654   else
655     {
656       NSString *fstr;
658       if (! NILP (filename))
659         {
660           GCPRO1 (filename);
661           encoded_filename = ENCODE_UTF_8 (filename);
662           UNGCPRO;
664           fstr = [NSString stringWithUTF8String: SSDATA (encoded_filename)];
665           if (fstr == nil) fstr = @"";
666 #ifdef NS_IMPL_COCOA
667           /* work around a bug observed on 10.3 and later where
668              setTitleWithRepresentedFilename does not clear out previous state
669              if given filename does not exist */
670           if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
671             [[view window] setRepresentedFilename: @""];
672 #endif
673         }
674       else
675         fstr = @"";
677       [[view window] setRepresentedFilename: fstr];
678       [[view window] setTitle: str];
679       FSET (f, name, name);
680     }
682   [pool release];
683   UNBLOCK_INPUT;
687 void
688 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
690   NSView *view = FRAME_NS_VIEW (f);
691   NSAutoreleasePool *pool;
692   if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
693     {
694       BLOCK_INPUT;
695       pool = [[NSAutoreleasePool alloc] init];
696       [[view window] setDocumentEdited: !NILP (arg)];
697       [pool release];
698       UNBLOCK_INPUT;
699     }
703 void
704 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
706   int nlines;
707   if (FRAME_MINIBUF_ONLY_P (f))
708     return;
710   if (TYPE_RANGED_INTEGERP (int, value))
711     nlines = XINT (value);
712   else
713     nlines = 0;
715   FRAME_MENU_BAR_LINES (f) = 0;
716   if (nlines)
717     {
718       FRAME_EXTERNAL_MENU_BAR (f) = 1;
719       /* does for all frames, whereas we just want for one frame
720          [NSMenu setMenuBarVisible: YES]; */
721     }
722   else
723     {
724       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
725         free_frame_menubar (f);
726       /*      [NSMenu setMenuBarVisible: NO]; */
727       FRAME_EXTERNAL_MENU_BAR (f) = 0;
728     }
732 /* toolbar support */
733 void
734 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
736   int nlines;
738   if (FRAME_MINIBUF_ONLY_P (f))
739     return;
741   if (RANGED_INTEGERP (0, value, INT_MAX))
742     nlines = XFASTINT (value);
743   else
744     nlines = 0;
746   if (nlines)
747     {
748       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
749       update_frame_tool_bar (f);
750     }
751   else
752     {
753       if (FRAME_EXTERNAL_TOOL_BAR (f))
754         {
755           free_frame_tool_bar (f);
756           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
757         }
758     }
760   x_set_window_size (f, 0, f->text_cols, f->text_lines);
764 void
765 ns_implicitly_set_icon_type (struct frame *f)
767   Lisp_Object tem;
768   EmacsView *view = FRAME_NS_VIEW (f);
769   id image = nil;
770   Lisp_Object chain, elt;
771   NSAutoreleasePool *pool;
772   BOOL setMini = YES;
774   NSTRACE (ns_implicitly_set_icon_type);
776   BLOCK_INPUT;
777   pool = [[NSAutoreleasePool alloc] init];
778   if (f->output_data.ns->miniimage
779       && [[NSString stringWithUTF8String: SSDATA (f->name)]
780                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
781     {
782       [pool release];
783       UNBLOCK_INPUT;
784       return;
785     }
787   tem = assq_no_quit (Qicon_type, f->param_alist);
788   if (CONSP (tem) && ! NILP (XCDR (tem)))
789     {
790       [pool release];
791       UNBLOCK_INPUT;
792       return;
793     }
795   for (chain = Vns_icon_type_alist;
796        image == nil && CONSP (chain);
797        chain = XCDR (chain))
798     {
799       elt = XCAR (chain);
800       /* special case: 't' means go by file type */
801       if (SYMBOLP (elt) && EQ (elt, Qt) && SSDATA (f->name)[0] == '/')
802         {
803           NSString *str
804              = [NSString stringWithUTF8String: SSDATA (f->name)];
805           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
806             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
807         }
808       else if (CONSP (elt) &&
809                STRINGP (XCAR (elt)) &&
810                STRINGP (XCDR (elt)) &&
811                fast_string_match (XCAR (elt), f->name) >= 0)
812         {
813           image = [EmacsImage allocInitFromFile: XCDR (elt)];
814           if (image == nil)
815             image = [[NSImage imageNamed:
816                                [NSString stringWithUTF8String:
817                                             SSDATA (XCDR (elt))]] retain];
818         }
819     }
821   if (image == nil)
822     {
823       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
824       setMini = NO;
825     }
827   [f->output_data.ns->miniimage release];
828   f->output_data.ns->miniimage = image;
829   [view setMiniwindowImage: setMini];
830   [pool release];
831   UNBLOCK_INPUT;
835 static void
836 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
838   EmacsView *view = FRAME_NS_VIEW (f);
839   id image = nil;
840   BOOL setMini = YES;
842   NSTRACE (x_set_icon_type);
844   if (!NILP (arg) && SYMBOLP (arg))
845     {
846       arg =build_string (SSDATA (SYMBOL_NAME (arg)));
847       store_frame_param (f, Qicon_type, arg);
848     }
850   /* do it the implicit way */
851   if (NILP (arg))
852     {
853       ns_implicitly_set_icon_type (f);
854       return;
855     }
857   CHECK_STRING (arg);
859   image = [EmacsImage allocInitFromFile: arg];
860   if (image == nil)
861     image =[NSImage imageNamed: [NSString stringWithUTF8String:
862                                             SSDATA (arg)]];
864   if (image == nil)
865     {
866       image = [NSImage imageNamed: @"text"];
867       setMini = NO;
868     }
870   f->output_data.ns->miniimage = image;
871   [view setMiniwindowImage: setMini];
875 /* Xism; we stub out (we do implement this in ns-win.el) */
877 XParseGeometry (char *string, int *x, int *y,
878                 unsigned int *width, unsigned int *height)
880   message1 ("Warning: XParseGeometry not supported under NS.\n");
881   return 0;
885 /* TODO: move to nsterm? */
887 ns_lisp_to_cursor_type (Lisp_Object arg)
889   char *str;
890   if (XTYPE (arg) == Lisp_String)
891     str = SSDATA (arg);
892   else if (XTYPE (arg) == Lisp_Symbol)
893     str = SSDATA (SYMBOL_NAME (arg));
894   else return -1;
895   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
896   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
897   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
898   if (!strcmp (str, "bar"))     return BAR_CURSOR;
899   if (!strcmp (str, "no"))      return NO_CURSOR;
900   return -1;
904 Lisp_Object
905 ns_cursor_type_to_lisp (int arg)
907   switch (arg)
908     {
909     case FILLED_BOX_CURSOR: return Qbox;
910     case HOLLOW_BOX_CURSOR: return intern ("hollow");
911     case HBAR_CURSOR:       return intern ("hbar");
912     case BAR_CURSOR:        return intern ("bar");
913     case NO_CURSOR:
914     default:                return intern ("no");
915     }
918 /* This is the same as the xfns.c definition.  */
919 void
920 x_set_cursor_type (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
922   set_frame_cursor_types (f, arg);
924   /* Make sure the cursor gets redrawn.  */
925   cursor_type_changed = 1;
929 /* called to set mouse pointer color, but all other terms use it to
930    initialize pointer types (and don't set the color ;) */
931 static void
932 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
934   /* don't think we can do this on Nextstep */
938 #define Str(x) #x
939 #define Xstr(x) Str(x)
941 static Lisp_Object
942 ns_appkit_version_str (void)
944   char tmp[80];
946 #ifdef NS_IMPL_GNUSTEP
947   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
948 #elif defined(NS_IMPL_COCOA)
949   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
950 #else
951   tmp = "ns-unknown";
952 #endif
953   return build_string (tmp);
957 /* This is for use by x-server-version and collapses all version info we
958    have into a single int.  For a better picture of the implementation
959    running, use ns_appkit_version_str.*/
960 static int
961 ns_appkit_version_int (void)
963 #ifdef NS_IMPL_GNUSTEP
964   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
965 #elif defined(NS_IMPL_COCOA)
966   return (int)NSAppKitVersionNumber;
967 #endif
968   return 0;
972 static void
973 x_icon (struct frame *f, Lisp_Object parms)
974 /* --------------------------------------------------------------------------
975    Strangely-named function to set icon position parameters in frame.
976    This is irrelevant under OS X, but might be needed under GNUstep,
977    depending on the window manager used.  Note, this is not a standard
978    frame parameter-setter; it is called directly from x-create-frame.
979    -------------------------------------------------------------------------- */
981   Lisp_Object icon_x, icon_y;
982   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
984   f->output_data.ns->icon_top = Qnil;
985   f->output_data.ns->icon_left = Qnil;
987   /* Set the position of the icon.  */
988   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
989   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
990   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
991     {
992       CHECK_NUMBER (icon_x);
993       CHECK_NUMBER (icon_y);
994       f->output_data.ns->icon_top = icon_y;
995       f->output_data.ns->icon_left = icon_x;
996     }
997   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
998     error ("Both left and top icon corners of icon must be specified");
1002 /* Note: see frame.c for template, also where generic functions are impl */
1003 frame_parm_handler ns_frame_parm_handlers[] =
1005   x_set_autoraise, /* generic OK */
1006   x_set_autolower, /* generic OK */
1007   x_set_background_color,
1008   0, /* x_set_border_color,  may be impossible under Nextstep */
1009   0, /* x_set_border_width,  may be impossible under Nextstep */
1010   x_set_cursor_color,
1011   x_set_cursor_type,
1012   x_set_font, /* generic OK */
1013   x_set_foreground_color,
1014   x_set_icon_name,
1015   x_set_icon_type,
1016   x_set_internal_border_width, /* generic OK */
1017   x_set_menu_bar_lines,
1018   x_set_mouse_color,
1019   x_explicitly_set_name,
1020   x_set_scroll_bar_width, /* generic OK */
1021   x_set_title,
1022   x_set_unsplittable, /* generic OK */
1023   x_set_vertical_scroll_bars, /* generic OK */
1024   x_set_visibility, /* generic OK */
1025   x_set_tool_bar_lines,
1026   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1027   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
1028   x_set_screen_gamma, /* generic OK */
1029   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1030   x_set_fringe_width, /* generic OK */
1031   x_set_fringe_width, /* generic OK */
1032   0, /* x_set_wait_for_wm, will ignore */
1033   0,  /* x_set_fullscreen will ignore */
1034   x_set_font_backend, /* generic OK */
1035   x_set_alpha,
1036   0, /* x_set_sticky */
1037   0, /* x_set_tool_bar_position */
1041 /* Handler for signals raised during x_create_frame.
1042    FRAME is the frame which is partially constructed.  */
1044 static Lisp_Object
1045 unwind_create_frame (Lisp_Object frame)
1047   struct frame *f = XFRAME (frame);
1049   /* If frame is already dead, nothing to do.  This can happen if the
1050      display is disconnected after the frame has become official, but
1051      before x_create_frame removes the unwind protect.  */
1052   if (!FRAME_LIVE_P (f))
1053     return Qnil;
1055   /* If frame is ``official'', nothing to do.  */
1056   if (NILP (Fmemq (frame, Vframe_list)))
1057     {
1058 #if defined GLYPH_DEBUG && defined ENABLE_CHECKING
1059       struct ns_display_info *dpyinfo = FRAME_X_DISPLAY_INFO (f);
1060 #endif
1062       x_free_frame_resources (f);
1063       free_glyphs (f);
1065 #ifdef GLYPH_DEBUG
1066       /* Check that reference counts are indeed correct.  */
1067       eassert (dpyinfo->terminal->image_cache->refcount == image_cache_refcount);
1068 #endif
1069       return Qt;
1070     }
1072   return Qnil;
1076  * Read geometry related parameters from preferences if not in PARMS.
1077  * Returns the union of parms and any preferences read.
1078  */
1080 static Lisp_Object
1081 get_geometry_from_preferences (struct ns_display_info *dpyinfo,
1082                                Lisp_Object parms)
1084   struct {
1085     const char *val;
1086     const char *cls;
1087     Lisp_Object tem;
1088   } r[] = {
1089     { "width",  "Width", Qwidth },
1090     { "height", "Height", Qheight },
1091     { "left", "Left", Qleft },
1092     { "top", "Top", Qtop },
1093   };
1095   int i;
1096   for (i = 0; i < sizeof (r)/sizeof (r[0]); ++i)
1097     {
1098       if (NILP (Fassq (r[i].tem, parms)))
1099         {
1100           Lisp_Object value
1101             = x_get_arg (dpyinfo, parms, r[i].tem, r[i].val, r[i].cls,
1102                          RES_TYPE_NUMBER);
1103           if (! EQ (value, Qunbound))
1104             parms = Fcons (Fcons (r[i].tem, value), parms);
1105         }
1106     }
1108   return parms;
1111 /* ==========================================================================
1113     Lisp definitions
1115    ========================================================================== */
1117 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1118        1, 1, 0,
1119        doc: /* Make a new Nextstep window, called a "frame" in Emacs terms.
1120 Return an Emacs frame object.
1121 PARMS is an alist of frame parameters.
1122 If the parameters specify that the frame should not have a minibuffer,
1123 and do not specify a specific minibuffer window to use,
1124 then `default-minibuffer-frame' must be a frame whose minibuffer can
1125 be shared by the new frame.
1127 This function is an internal primitive--use `make-frame' instead.  */)
1128      (Lisp_Object parms)
1130   struct frame *f;
1131   Lisp_Object frame, tem;
1132   Lisp_Object name;
1133   int minibuffer_only = 0;
1134   int window_prompting = 0;
1135   int width, height;
1136   ptrdiff_t count = specpdl_ptr - specpdl;
1137   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1138   Lisp_Object display;
1139   struct ns_display_info *dpyinfo = NULL;
1140   Lisp_Object parent;
1141   struct kboard *kb;
1142   Lisp_Object tfont, tfontsize;
1143   static int desc_ctr = 1;
1145   check_ns ();
1147   /* x_get_arg modifies parms.  */
1148   parms = Fcopy_alist (parms);
1150   /* Use this general default value to start with
1151      until we know if this frame has a specified name.  */
1152   Vx_resource_name = Vinvocation_name;
1154   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1155   if (EQ (display, Qunbound))
1156     display = Qnil;
1157   dpyinfo = check_ns_display_info (display);
1158   kb = dpyinfo->terminal->kboard;
1160   if (!dpyinfo->terminal->name)
1161     error ("Terminal is not live, can't create new frames on it");
1163   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1164   if (!STRINGP (name)
1165       && ! EQ (name, Qunbound)
1166       && ! NILP (name))
1167     error ("Invalid frame name--not a string or nil");
1169   if (STRINGP (name))
1170     Vx_resource_name = name;
1172   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1173   if (EQ (parent, Qunbound))
1174     parent = Qnil;
1175   if (! NILP (parent))
1176     CHECK_NUMBER (parent);
1178   /* make_frame_without_minibuffer can run Lisp code and garbage collect.  */
1179   /* No need to protect DISPLAY because that's not used after passing
1180      it to make_frame_without_minibuffer.  */
1181   frame = Qnil;
1182   GCPRO4 (parms, parent, name, frame);
1183   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1184                   RES_TYPE_SYMBOL);
1185   if (EQ (tem, Qnone) || NILP (tem))
1186       f = make_frame_without_minibuffer (Qnil, kb, display);
1187   else if (EQ (tem, Qonly))
1188     {
1189       f = make_minibuffer_frame ();
1190       minibuffer_only = 1;
1191     }
1192   else if (WINDOWP (tem))
1193       f = make_frame_without_minibuffer (tem, kb, display);
1194   else
1195       f = make_frame (1);
1197   XSETFRAME (frame, f);
1198   FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1200   f->terminal = dpyinfo->terminal;
1202   f->output_method = output_ns;
1203   f->output_data.ns = xzalloc (sizeof *f->output_data.ns);
1205   FRAME_FONTSET (f) = -1;
1207   FSET (f, icon_name, x_get_arg (dpyinfo, parms, Qicon_name,
1208                                  "iconName", "Title",
1209                                  RES_TYPE_STRING));
1210   if (! STRINGP (f->icon_name))
1211     FSET (f, icon_name, Qnil);
1213   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1215   /* With FRAME_NS_DISPLAY_INFO set up, this unwind-protect is safe.  */
1216   record_unwind_protect (unwind_create_frame, frame);
1218   f->output_data.ns->window_desc = desc_ctr++;
1219   if (TYPE_RANGED_INTEGERP (Window, parent))
1220     {
1221       f->output_data.ns->parent_desc = XFASTINT (parent);
1222       f->output_data.ns->explicit_parent = 1;
1223     }
1224   else
1225     {
1226       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1227       f->output_data.ns->explicit_parent = 0;
1228     }
1230   /* Set the name; the functions to which we pass f expect the name to
1231      be set.  */
1232   if (EQ (name, Qunbound) || NILP (name) || ! STRINGP (name))
1233     {
1234       FSET (f, name, build_string ([ns_app_name UTF8String]));
1235       f->explicit_name = 0;
1236     }
1237   else
1238     {
1239       FSET (f, name, name);
1240       f->explicit_name = 1;
1241       specbind (Qx_resource_name, name);
1242     }
1244   f->resx = dpyinfo->resx;
1245   f->resy = dpyinfo->resy;
1247   BLOCK_INPUT;
1248   register_font_driver (&nsfont_driver, f);
1249   x_default_parameter (f, parms, Qfont_backend, Qnil,
1250                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1252   {
1253     /* use for default font name */
1254     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1255     tfontsize = x_default_parameter (f, parms, Qfontsize,
1256                                     make_number (0 /*(int)[font pointSize]*/),
1257                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1258     tfont = x_default_parameter (f, parms, Qfont,
1259                                  build_string ([[font fontName] UTF8String]),
1260                                  "font", "Font", RES_TYPE_STRING);
1261   }
1262   UNBLOCK_INPUT;
1264   x_default_parameter (f, parms, Qborder_width, make_number (0),
1265                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1266   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1267                       "internalBorderWidth", "InternalBorderWidth",
1268                       RES_TYPE_NUMBER);
1270   /* default scrollbars on right on Mac */
1271   {
1272       Lisp_Object spos
1273 #ifdef NS_IMPL_GNUSTEP
1274           = Qt;
1275 #else
1276           = Qright;
1277 #endif
1278       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1279                            "verticalScrollBars", "VerticalScrollBars",
1280                            RES_TYPE_SYMBOL);
1281   }
1282   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1283                       "foreground", "Foreground", RES_TYPE_STRING);
1284   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1285                       "background", "Background", RES_TYPE_STRING);
1286   /* FIXME: not supported yet in Nextstep */
1287   x_default_parameter (f, parms, Qline_spacing, Qnil,
1288                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1289   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1290                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1291   x_default_parameter (f, parms, Qright_fringe, Qnil,
1292                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1294 #ifdef GLYPH_DEBUG
1295   image_cache_refcount =
1296     FRAME_IMAGE_CACHE (f) ? FRAME_IMAGE_CACHE (f)->refcount : 0;
1297 #endif
1299   init_frame_faces (f);
1301   /* The resources controlling the menu-bar and tool-bar are
1302      processed specially at startup, and reflected in the mode
1303      variables; ignore them here.  */
1304   x_default_parameter (f, parms, Qmenu_bar_lines,
1305                        NILP (Vmenu_bar_mode)
1306                        ? make_number (0) : make_number (1),
1307                        NULL, NULL, RES_TYPE_NUMBER);
1308   x_default_parameter (f, parms, Qtool_bar_lines,
1309                        NILP (Vtool_bar_mode)
1310                        ? make_number (0) : make_number (1),
1311                        NULL, NULL, RES_TYPE_NUMBER);
1313   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1314                        "BufferPredicate", RES_TYPE_SYMBOL);
1315   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1316                        RES_TYPE_STRING);
1318   parms = get_geometry_from_preferences (dpyinfo, parms);
1319   window_prompting = x_figure_window_size (f, parms, 1);
1321   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1322   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1324   /* NOTE: on other terms, this is done in set_mouse_color, however this
1325      was not getting called under Nextstep */
1326   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1327   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1328   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1329   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1330   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1331   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1332   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1333      = [NSCursor arrowCursor];
1334   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1336   [[EmacsView alloc] initFrameFromEmacs: f];
1338   x_icon (f, parms);
1340   /* ns_display_info does not have a reference_count.  */
1341   f->terminal->reference_count++;
1343   /* It is now ok to make the frame official even if we get an error below.
1344      The frame needs to be on Vframe_list or making it visible won't work. */
1345   Vframe_list = Fcons (frame, Vframe_list);
1347   x_default_parameter (f, parms, Qicon_type, Qnil,
1348                        "bitmapIcon", "BitmapIcon", RES_TYPE_SYMBOL);
1350   x_default_parameter (f, parms, Qauto_raise, Qnil,
1351                        "autoRaise", "AutoRaiseLower", RES_TYPE_BOOLEAN);
1352   x_default_parameter (f, parms, Qauto_lower, Qnil,
1353                        "autoLower", "AutoLower", RES_TYPE_BOOLEAN);
1354   x_default_parameter (f, parms, Qcursor_type, Qbox,
1355                        "cursorType", "CursorType", RES_TYPE_SYMBOL);
1356   x_default_parameter (f, parms, Qscroll_bar_width, Qnil,
1357                        "scrollBarWidth", "ScrollBarWidth",
1358                        RES_TYPE_NUMBER);
1359   x_default_parameter (f, parms, Qalpha, Qnil,
1360                        "alpha", "Alpha", RES_TYPE_NUMBER);
1362   width = FRAME_COLS (f);
1363   height = FRAME_LINES (f);
1365   SET_FRAME_COLS (f, 0);
1366   FRAME_LINES (f) = 0;
1367   change_frame_size (f, height, width, 1, 0, 0);
1369   if (! f->output_data.ns->explicit_parent)
1370     {
1371       Lisp_Object visibility;
1373       visibility = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0,
1374                               RES_TYPE_SYMBOL);
1375       if (EQ (visibility, Qunbound))
1376         visibility = Qt;
1378       if (EQ (visibility, Qicon))
1379         x_iconify_frame (f);
1380       else if (! NILP (visibility))
1381         {
1382           x_make_frame_visible (f);
1383           [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1384         }
1385       else
1386         {
1387           /* Must have been Qnil.  */
1388         }
1389     }
1391   if (FRAME_HAS_MINIBUF_P (f)
1392       && (!FRAMEP (KVAR (kb, Vdefault_minibuffer_frame))
1393           || !FRAME_LIVE_P (XFRAME (KVAR (kb, Vdefault_minibuffer_frame)))))
1394     KVAR (kb, Vdefault_minibuffer_frame) = frame;
1396   /* All remaining specified parameters, which have not been "used"
1397      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1398   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1399     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1400       FSET (f, param_alist, Fcons (XCAR (tem), f->param_alist));
1402   UNGCPRO;
1404   /* Make sure windows on this frame appear in calls to next-window
1405      and similar functions.  */
1406   Vwindow_list = Qnil;
1408   return unbind_to (count, frame);
1412 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1413        doc: /* Set the input focus to FRAME.
1414 FRAME nil means use the selected frame.  */)
1415      (Lisp_Object frame)
1417   struct frame *f = check_ns_frame (frame);
1418   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1420   if (dpyinfo->x_focus_frame != f)
1421     {
1422       EmacsView *view = FRAME_NS_VIEW (f);
1423       BLOCK_INPUT;
1424       [NSApp activateIgnoringOtherApps: YES];
1425       [[view window] makeKeyAndOrderFront: view];
1426       UNBLOCK_INPUT;
1427     }
1429   return Qnil;
1433 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1434        0, 1, "",
1435        doc: /* Pop up the font panel. */)
1436      (Lisp_Object frame)
1438   id fm;
1439   struct frame *f;
1441   check_ns ();
1442   fm = [NSFontManager sharedFontManager];
1443   if (NILP (frame))
1444     f = SELECTED_FRAME ();
1445   else
1446     {
1447       CHECK_FRAME (frame);
1448       f = XFRAME (frame);
1449     }
1451   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1452            isMultiple: NO];
1453   [fm orderFrontFontPanel: NSApp];
1454   return Qnil;
1458 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1459        0, 1, "",
1460        doc: /* Pop up the color panel.  */)
1461      (Lisp_Object frame)
1463   struct frame *f;
1465   check_ns ();
1466   if (NILP (frame))
1467     f = SELECTED_FRAME ();
1468   else
1469     {
1470       CHECK_FRAME (frame);
1471       f = XFRAME (frame);
1472     }
1474   [NSApp orderFrontColorPanel: NSApp];
1475   return Qnil;
1479 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1480        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1481 Optional arg DIR, if non-nil, supplies a default directory.
1482 Optional arg MUSTMATCH, if non-nil, means the returned file or
1483 directory must exist.
1484 Optional arg INIT, if non-nil, provides a default file name to use.  */)
1485      (Lisp_Object prompt, Lisp_Object dir, Lisp_Object mustmatch, Lisp_Object init)
1487   static id fileDelegate = nil;
1488   int ret;
1489   id panel;
1490   Lisp_Object fname;
1492   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1493     [NSString stringWithUTF8String: SSDATA (prompt)];
1494   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1495     [NSString stringWithUTF8String: SSDATA (BVAR (current_buffer, directory))] :
1496     [NSString stringWithUTF8String: SSDATA (dir)];
1497   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1498     [NSString stringWithUTF8String: SSDATA (init)];
1500   check_ns ();
1502   if (fileDelegate == nil)
1503     fileDelegate = [EmacsFileDelegate new];
1505   [NSCursor setHiddenUntilMouseMoves: NO];
1507   if ([dirS characterAtIndex: 0] == '~')
1508     dirS = [dirS stringByExpandingTildeInPath];
1510   panel = NILP (mustmatch) ?
1511     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1513   [panel setTitle: promptS];
1515   /* Puma (10.1) does not have */
1516   if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1517     [panel setAllowsOtherFileTypes: YES];
1519   [panel setTreatsFilePackagesAsDirectories: YES];
1520   [panel setDelegate: fileDelegate];
1522   panelOK = 0;
1523   BLOCK_INPUT;
1524   if (NILP (mustmatch))
1525     {
1526       ret = [panel runModalForDirectory: dirS file: initS];
1527     }
1528   else
1529     {
1530       [panel setCanChooseDirectories: YES];
1531       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1532     }
1534   ret = (ret == NSOKButton) || panelOK;
1536   if (ret)
1537     fname = build_string ([[panel filename] UTF8String]);
1539   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1540   UNBLOCK_INPUT;
1542   return ret ? fname : Qnil;
1545 const char *
1546 ns_get_defaults_value (const char *key)
1548   NSObject *obj = [[NSUserDefaults standardUserDefaults]
1549                     objectForKey: [NSString stringWithUTF8String: key]];
1551   if (!obj) return NULL;
1553   return [[NSString stringWithFormat: @"%@", obj] UTF8String];
1557 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1558        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1559 If OWNER is nil, Emacs is assumed.  */)
1560      (Lisp_Object owner, Lisp_Object name)
1562   const char *value;
1564   check_ns ();
1565   if (NILP (owner))
1566     owner = build_string([ns_app_name UTF8String]);
1567   CHECK_STRING (name);
1568 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SSDATA (name)); */
1570   value = ns_get_defaults_value (SSDATA (name));
1572   if (value)
1573     return build_string (value);
1574   return Qnil;
1578 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1579        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1580 If OWNER is nil, Emacs is assumed.
1581 If VALUE is nil, the default is removed.  */)
1582      (Lisp_Object owner, Lisp_Object name, Lisp_Object value)
1584   check_ns ();
1585   if (NILP (owner))
1586     owner = build_string ([ns_app_name UTF8String]);
1587   CHECK_STRING (name);
1588   if (NILP (value))
1589     {
1590       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1591                          [NSString stringWithUTF8String: SSDATA (name)]];
1592     }
1593   else
1594     {
1595       CHECK_STRING (value);
1596       [[NSUserDefaults standardUserDefaults] setObject:
1597                 [NSString stringWithUTF8String: SSDATA (value)]
1598                                         forKey: [NSString stringWithUTF8String:
1599                                                          SSDATA (name)]];
1600     }
1602   return Qnil;
1606 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1607        Sx_server_max_request_size,
1608        0, 1, 0,
1609        doc: /* This function is a no-op.  It is only present for completeness.  */)
1610      (Lisp_Object display)
1612   check_ns ();
1613   /* This function has no real equivalent under NeXTstep.  Return nil to
1614      indicate this. */
1615   return Qnil;
1619 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1620        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1621 DISPLAY should be either a frame or a display name (a string).
1622 If omitted or nil, the selected frame's display is used.  */)
1623      (Lisp_Object display)
1625 #ifdef NS_IMPL_GNUSTEP
1626   return build_string ("GNU");
1627 #else
1628   return build_string ("Apple");
1629 #endif
1633 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1634        doc: /* Return the version numbers of the server of DISPLAY.
1635 The value is a list of three integers: the major and minor
1636 version numbers of the X Protocol in use, and the distributor-specific
1637 release number.  See also the function `x-server-vendor'.
1639 The optional argument DISPLAY specifies which display to ask about.
1640 DISPLAY should be either a frame or a display name (a string).
1641 If omitted or nil, that stands for the selected frame's display.  */)
1642      (Lisp_Object display)
1644   /*NOTE: it is unclear what would best correspond with "protocol";
1645           we return 10.3, meaning Panther, since this is roughly the
1646           level that GNUstep's APIs correspond to.
1647           The last number is where we distinguish between the Apple
1648           and GNUstep implementations ("distributor-specific release
1649           number") and give int'ized versions of major.minor. */
1650   return Fcons (make_number (10),
1651                 Fcons (make_number (3),
1652                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1656 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1657        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1658 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1659 If omitted or nil, the selected frame's display is used.  */)
1660      (Lisp_Object display)
1662   int num;
1664   check_ns ();
1665   num = [[NSScreen screens] count];
1667   return (num != 0) ? make_number (num) : Qnil;
1671 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1672        0, 1, 0,
1673        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1674 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1675 If omitted or nil, the selected frame's display is used.  */)
1676      (Lisp_Object display)
1678   check_ns ();
1679   return make_number ((int)
1680                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1684 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1685        0, 1, 0,
1686        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1687 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1688 If omitted or nil, the selected frame's display is used.  */)
1689      (Lisp_Object display)
1691   check_ns ();
1692   return make_number ((int)
1693                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1697 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1698        Sx_display_backing_store, 0, 1, 0,
1699        doc: /* Return whether the Nextstep display DISPLAY supports backing store.
1700 The value may be `buffered', `retained', or `non-retained'.
1701 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1702 If omitted or nil, the selected frame's display is used.  */)
1703      (Lisp_Object display)
1705   check_ns ();
1706   switch ([ns_get_window (display) backingType])
1707     {
1708     case NSBackingStoreBuffered:
1709       return intern ("buffered");
1710     case NSBackingStoreRetained:
1711       return intern ("retained");
1712     case NSBackingStoreNonretained:
1713       return intern ("non-retained");
1714     default:
1715       error ("Strange value for backingType parameter of frame");
1716     }
1717   return Qnil;  /* not reached, shut compiler up */
1721 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1722        Sx_display_visual_class, 0, 1, 0,
1723        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1724 The value is one of the symbols `static-gray', `gray-scale',
1725 `static-color', `pseudo-color', `true-color', or `direct-color'.
1726 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1727 If omitted or nil, the selected frame's display is used.  */)
1728      (Lisp_Object display)
1730   NSWindowDepth depth;
1731   check_ns ();
1732   depth = [ns_get_screen (display) depth];
1734   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1735     return intern ("static-gray");
1736   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1737     return intern ("gray-scale");
1738   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1739     return intern ("pseudo-color");
1740   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1741     return intern ("true-color");
1742   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1743     return intern ("direct-color");
1744   else
1745     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1746     return intern ("direct-color");
1750 DEFUN ("x-display-save-under", Fx_display_save_under,
1751        Sx_display_save_under, 0, 1, 0,
1752        doc: /* Return t if DISPLAY supports the save-under feature.
1753 The optional argument DISPLAY specifies which display to ask about.
1754 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1755 If omitted or nil, the selected frame's display is used.  */)
1756      (Lisp_Object display)
1758   check_ns ();
1759   switch ([ns_get_window (display) backingType])
1760     {
1761     case NSBackingStoreBuffered:
1762       return Qt;
1764     case NSBackingStoreRetained:
1765     case NSBackingStoreNonretained:
1766       return Qnil;
1768     default:
1769       error ("Strange value for backingType parameter of frame");
1770     }
1771   return Qnil;  /* not reached, shut compiler up */
1775 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1776        1, 3, 0,
1777        doc: /* Open a connection to a display server.
1778 DISPLAY is the name of the display to connect to.
1779 Optional second arg XRM-STRING is a string of resources in xrdb format.
1780 If the optional third arg MUST-SUCCEED is non-nil,
1781 terminate Emacs if we can't open the connection.
1782 \(In the Nextstep version, the last two arguments are currently ignored.)  */)
1783      (Lisp_Object display, Lisp_Object resource_string, Lisp_Object must_succeed)
1785   struct ns_display_info *dpyinfo;
1787   CHECK_STRING (display);
1789   nxatoms_of_nsselect ();
1790   dpyinfo = ns_term_init (display);
1791   if (dpyinfo == 0)
1792     {
1793       if (!NILP (must_succeed))
1794         fatal ("OpenStep on %s not responding.\n",
1795                SSDATA (display));
1796       else
1797         error ("OpenStep on %s not responding.\n",
1798                SSDATA (display));
1799     }
1801   /* Register our external input/output types, used for determining
1802      applicable services and also drag/drop eligibility. */
1803   ns_send_types = [[NSArray arrayWithObjects: NSStringPboardType, nil] retain];
1804   ns_return_types = [[NSArray arrayWithObjects: NSStringPboardType, nil]
1805                       retain];
1806   ns_drag_types = [[NSArray arrayWithObjects:
1807                             NSStringPboardType,
1808                             NSTabularTextPboardType,
1809                             NSFilenamesPboardType,
1810                             NSURLPboardType,
1811                             NSColorPboardType,
1812                             NSFontPboardType, nil] retain];
1814   return Qnil;
1818 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1819        1, 1, 0,
1820        doc: /* Close the connection to the current Nextstep display server.
1821 The argument DISPLAY is currently ignored.  */)
1822      (Lisp_Object display)
1824   check_ns ();
1825   /*ns_delete_terminal (dpyinfo->terminal); */
1826   [NSApp terminate: NSApp];
1827   return Qnil;
1831 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1832        doc: /* Return the list of display names that Emacs has connections to.  */)
1833      (void)
1835   Lisp_Object tail, result;
1837   result = Qnil;
1838   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1839     result = Fcons (XCAR (XCAR (tail)), result);
1841   return result;
1845 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1846        0, 0, 0,
1847        doc: /* Hides all applications other than Emacs.  */)
1848      (void)
1850   check_ns ();
1851   [NSApp hideOtherApplications: NSApp];
1852   return Qnil;
1855 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1856        1, 1, 0,
1857        doc: /* If ON is non-nil, the entire Emacs application is hidden.
1858 Otherwise if Emacs is hidden, it is unhidden.
1859 If ON is equal to `activate', Emacs is unhidden and becomes
1860 the active application.  */)
1861      (Lisp_Object on)
1863   check_ns ();
1864   if (EQ (on, intern ("activate")))
1865     {
1866       [NSApp unhide: NSApp];
1867       [NSApp activateIgnoringOtherApps: YES];
1868     }
1869   else if (NILP (on))
1870     [NSApp unhide: NSApp];
1871   else
1872     [NSApp hide: NSApp];
1873   return Qnil;
1877 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1878        0, 0, 0,
1879        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1880      (void)
1882   check_ns ();
1883   [NSApp orderFrontStandardAboutPanel: nil];
1884   return Qnil;
1888 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1889        doc: /* Determine font PostScript or family name for font NAME.
1890 NAME should be a string containing either the font name or an XLFD
1891 font descriptor.  If string contains `fontset' and not
1892 `fontset-startup', it is left alone. */)
1893      (Lisp_Object name)
1895   char *nm;
1896   CHECK_STRING (name);
1897   nm = SSDATA (name);
1899   if (nm[0] != '-')
1900     return name;
1901   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1902     return name;
1904   return build_string (ns_xlfd_to_fontname (SSDATA (name)));
1908 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1909        doc: /* Return a list of all available colors.
1910 The optional argument FRAME is currently ignored.  */)
1911      (Lisp_Object frame)
1913   Lisp_Object list = Qnil;
1914   NSEnumerator *colorlists;
1915   NSColorList *clist;
1917   if (!NILP (frame))
1918     {
1919       CHECK_FRAME (frame);
1920       if (! FRAME_NS_P (XFRAME (frame)))
1921         error ("non-Nextstep frame used in `ns-list-colors'");
1922     }
1924   BLOCK_INPUT;
1926   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1927   while ((clist = [colorlists nextObject]))
1928     {
1929       if ([[clist name] length] < 7 ||
1930           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1931         {
1932           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1933           NSString *cname;
1934           while ((cname = [cnames nextObject]))
1935             list = Fcons (build_string ([cname UTF8String]), list);
1936 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1937                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1938                                              UTF8String]), list); */
1939         }
1940     }
1942   UNBLOCK_INPUT;
1944   return list;
1948 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1949        doc: /* List available Nextstep services by querying NSApp.  */)
1950      (void)
1952 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
1953   /* You can't get services like this in 10.6+.  */
1954   return Qnil;
1955 #else
1956   Lisp_Object ret = Qnil;
1957   NSMenu *svcs;
1958   id delegate;
1960   check_ns ();
1961   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1962   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
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   if (NSAppKitVersionNumber >= 744.0)
1970     {
1971       delegate = [svcs delegate];
1972       if (delegate != nil)
1973         {
1974           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1975               [delegate menuNeedsUpdate: svcs];
1976           if ([delegate respondsToSelector:
1977                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1978             {
1979               int i, len = [delegate numberOfItemsInMenu: svcs];
1980               for (i =0; i<len; i++)
1981                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1982               for (i =0; i<len; i++)
1983                   if (![delegate menu: svcs
1984                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1985                               atIndex: i shouldCancel: NO])
1986                     break;
1987             }
1988         }
1989     }
1990 #endif
1992   [svcs setAutoenablesItems: NO];
1993 #ifdef NS_IMPL_COCOA
1994   [svcs update]; /* on OS X, converts from '/' structure */
1995 #endif
1997   ret = interpret_services_menu (svcs, Qnil, ret);
1998   return ret;
1999 #endif
2003 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
2004        2, 2, 0,
2005        doc: /* Perform Nextstep SERVICE on SEND.
2006 SEND should be either a string or nil.
2007 The return value is the result of the service, as string, or nil if
2008 there was no result.  */)
2009      (Lisp_Object service, Lisp_Object send)
2011   id pb;
2012   NSString *svcName;
2013   char *utfStr;
2015   CHECK_STRING (service);
2016   check_ns ();
2018   utfStr = SSDATA (service);
2019   svcName = [NSString stringWithUTF8String: utfStr];
2021   pb =[NSPasteboard pasteboardWithUniqueName];
2022   ns_string_to_pasteboard (pb, send);
2024   if (NSPerformService (svcName, pb) == NO)
2025     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2027   if ([[pb types] count] == 0)
2028     return build_string ("");
2029   return ns_string_from_pasteboard (pb);
2033 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2034        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2035        doc: /* Return an NFC string that matches the UTF-8 NFD string STR.  */)
2036      (Lisp_Object str)
2038 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2039          remove this. */
2040   NSString *utfStr;
2042   CHECK_STRING (str);
2043   utfStr = [NSString stringWithUTF8String: SSDATA (str)];
2044   if (![utfStr respondsToSelector:
2045                  @selector (precomposedStringWithCanonicalMapping)])
2046     {
2047       message1
2048         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2049       return Qnil;
2050     }
2051   else
2052     utfStr = [utfStr precomposedStringWithCanonicalMapping];
2053   return build_string ([utfStr UTF8String]);
2057 #ifdef NS_IMPL_COCOA
2059 /* Compile and execute the AppleScript SCRIPT and return the error
2060    status as function value.  A zero is returned if compilation and
2061    execution is successful, in which case *RESULT is set to a Lisp
2062    string or a number containing the resulting script value.  Otherwise,
2063    1 is returned. */
2064 static int
2065 ns_do_applescript (Lisp_Object script, Lisp_Object *result)
2067   NSAppleEventDescriptor *desc;
2068   NSDictionary* errorDict;
2069   NSAppleEventDescriptor* returnDescriptor = NULL;
2071   NSAppleScript* scriptObject =
2072     [[NSAppleScript alloc] initWithSource:
2073                              [NSString stringWithUTF8String: SSDATA (script)]];
2075   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2076   [scriptObject release];
2078   *result = Qnil;
2080   if (returnDescriptor != NULL)
2081     {
2082       // successful execution
2083       if (kAENullEvent != [returnDescriptor descriptorType])
2084         {
2085           *result = Qt;
2086           // script returned an AppleScript result
2087           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2088 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2089               (typeUTF16ExternalRepresentation
2090                == [returnDescriptor descriptorType]) ||
2091 #endif
2092               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2093               (typeCString == [returnDescriptor descriptorType]))
2094             {
2095               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2096               if (desc)
2097                 *result = build_string([[desc stringValue] UTF8String]);
2098             }
2099           else
2100             {
2101               /* use typeUTF16ExternalRepresentation? */
2102               // coerce the result to the appropriate ObjC type
2103               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2104               if (desc)
2105                 *result = make_number([desc int32Value]);
2106             }
2107         }
2108     }
2109   else
2110     {
2111       // no script result, return error
2112       return 1;
2113     }
2114   return 0;
2117 /* Helper function called from sendEvent to run applescript
2118    from within the main event loop.  */
2120 void
2121 ns_run_ascript (void)
2123   as_status = ns_do_applescript (as_script, as_result);
2126 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2127        doc: /* Execute AppleScript SCRIPT and return the result.
2128 If compilation and execution are successful, the resulting script value
2129 is returned as a string, a number or, in the case of other constructs, t.
2130 In case the execution fails, an error is signaled. */)
2131      (Lisp_Object script)
2133   Lisp_Object result;
2134   int status;
2135   NSEvent *nxev;
2137   CHECK_STRING (script);
2138   check_ns ();
2140   BLOCK_INPUT;
2142   as_script = script;
2143   as_result = &result;
2145   /* executing apple script requires the event loop to run, otherwise
2146      errors aren't returned and executeAndReturnError hangs forever.
2147      Post an event that runs applescript and then start the event loop.
2148      The event loop is exited when the script is done.  */
2149   nxev = [NSEvent otherEventWithType: NSApplicationDefined
2150                             location: NSMakePoint (0, 0)
2151                        modifierFlags: 0
2152                            timestamp: 0
2153                         windowNumber: [[NSApp mainWindow] windowNumber]
2154                              context: [NSApp context]
2155                              subtype: 0
2156                                data1: 0
2157                                data2: NSAPP_DATA2_RUNASSCRIPT];
2159   [NSApp postEvent: nxev atStart: NO];
2160   [NSApp run];
2162   status = as_status;
2163   as_status = 0;
2164   as_script = Qnil;
2165   as_result = 0;
2166   UNBLOCK_INPUT;
2167   if (status == 0)
2168     return result;
2169   else if (!STRINGP (result))
2170     error ("AppleScript error %d", status);
2171   else
2172     error ("%s", SSDATA (result));
2174 #endif
2178 /* ==========================================================================
2180     Miscellaneous functions not called through hooks
2182    ========================================================================== */
2185 /* called from image.c */
2186 FRAME_PTR
2187 check_x_frame (Lisp_Object frame)
2189   return check_ns_frame (frame);
2193 /* called from frame.c */
2194 struct ns_display_info *
2195 check_x_display_info (Lisp_Object frame)
2197   return check_ns_display_info (frame);
2201 void
2202 x_set_scroll_bar_default_width (struct frame *f)
2204   int wid = FRAME_COLUMN_WIDTH (f);
2205   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2206   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2207                                       wid - 1) / wid;
2211 /* terms impl this instead of x-get-resource directly */
2212 const char *
2213 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2215   /* remove appname prefix; TODO: allow for !="Emacs" */
2216   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2217   const char *res;
2218   check_ns ();
2220   if (inhibit_x_resources)
2221     /* --quick was passed, so this is a no-op.  */
2222     return NULL;
2224   res = ns_get_defaults_value (toCheck);
2225   return !res ? NULL :
2226       (!c_strncasecmp (res, "YES", 3) ? "true" :
2227           (!c_strncasecmp (res, "NO", 2) ? "false" : res));
2231 Lisp_Object
2232 x_get_focus_frame (struct frame *frame)
2234   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2235   Lisp_Object nsfocus;
2237   if (!dpyinfo->x_focus_frame)
2238     return Qnil;
2240   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2241   return nsfocus;
2246 x_pixel_width (struct frame *f)
2248   return FRAME_PIXEL_WIDTH (f);
2253 x_pixel_height (struct frame *f)
2255   return FRAME_PIXEL_HEIGHT (f);
2260 x_char_width (struct frame *f)
2262   return FRAME_COLUMN_WIDTH (f);
2267 x_char_height (struct frame *f)
2269   return FRAME_LINE_HEIGHT (f);
2274 x_screen_planes (struct frame *f)
2276   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2280 void
2281 x_sync (struct frame *f)
2283   /* XXX Not implemented XXX */
2284   return;
2289 /* ==========================================================================
2291     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2293    ========================================================================== */
2296 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2297        doc: /* Internal function called by `color-defined-p', which see.
2298 \(Note that the Nextstep version of this function ignores FRAME.)  */)
2299      (Lisp_Object color, Lisp_Object frame)
2301   NSColor * col;
2302   check_ns ();
2303   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2307 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2308        doc: /* Internal function called by `color-values', which see.  */)
2309      (Lisp_Object color, Lisp_Object frame)
2311   NSColor * col;
2312   CGFloat red, green, blue, alpha;
2314   check_ns ();
2315   CHECK_STRING (color);
2317   if (ns_lisp_to_color (color, &col))
2318     return Qnil;
2320   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2321         getRed: &red green: &green blue: &blue alpha: &alpha];
2322   return list3 (make_number (lrint (red*65280)),
2323                 make_number (lrint (green*65280)),
2324                 make_number (lrint (blue*65280)));
2328 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2329        doc: /* Internal function called by `display-color-p', which see.  */)
2330      (Lisp_Object display)
2332   NSWindowDepth depth;
2333   NSString *colorSpace;
2334   check_ns ();
2335   depth = [ns_get_screen (display) depth];
2336   colorSpace = NSColorSpaceFromDepth (depth);
2338   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2339          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2340       ? Qnil : Qt;
2344 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2345        Sx_display_grayscale_p, 0, 1, 0,
2346        doc: /* Return t if the Nextstep display supports shades of gray.
2347 Note that color displays do support shades of gray.
2348 The optional argument DISPLAY specifies which display to ask about.
2349 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2350 If omitted or nil, that stands for the selected frame's display. */)
2351      (Lisp_Object display)
2353   NSWindowDepth depth;
2354   check_ns ();
2355   depth = [ns_get_screen (display) depth];
2357   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2361 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2362        0, 1, 0,
2363        doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2364 The optional argument DISPLAY specifies which display to ask about.
2365 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2366 If omitted or nil, that stands for the selected frame's display.  */)
2367      (Lisp_Object display)
2369   check_ns ();
2370   return make_number ((int) [ns_get_screen (display) frame].size.width);
2374 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2375        Sx_display_pixel_height, 0, 1, 0,
2376        doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2377 The optional argument DISPLAY specifies which display to ask about.
2378 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2379 If omitted or nil, that stands for the selected frame's display.  */)
2380      (Lisp_Object display)
2382   check_ns ();
2383   return make_number ((int) [ns_get_screen (display) frame].size.height);
2387 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2388        Sns_display_usable_bounds, 0, 1, 0,
2389        doc: /* Return the bounds of the usable part of the screen.
2390 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2391 are the boundaries of the usable part of the screen, excluding areas
2392 reserved for the Mac menu, dock, and so forth.
2394 The screen queried corresponds to DISPLAY, which should be either a
2395 frame, a display name (a string), or terminal ID.  If omitted or nil,
2396 that stands for the selected frame's display. */)
2397      (Lisp_Object display)
2399   NSScreen *screen;
2400   NSRect vScreen;
2402   check_ns ();
2403   screen = ns_get_screen (display);
2404   if (!screen)
2405     return Qnil;
2407   vScreen = [screen visibleFrame];
2409   /* NS coordinate system is upside-down.
2410      Transform to screen-specific coordinates. */
2411   return list4 (make_number ((int) vScreen.origin.x),
2412                 make_number ((int) [screen frame].size.height
2413                              - vScreen.size.height - vScreen.origin.y),
2414                 make_number ((int) vScreen.size.width),
2415                 make_number ((int) vScreen.size.height));
2419 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2420        0, 1, 0,
2421        doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
2422 The optional argument DISPLAY specifies which display to ask about.
2423 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2424 If omitted or nil, that stands for the selected frame's display.  */)
2425      (Lisp_Object display)
2427   check_ns ();
2428   return make_number
2429     (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2433 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2434        Sx_display_color_cells, 0, 1, 0,
2435        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2436 The optional argument DISPLAY specifies which display to ask about.
2437 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2438 If omitted or nil, that stands for the selected frame's display.  */)
2439      (Lisp_Object display)
2441   struct ns_display_info *dpyinfo;
2442   check_ns ();
2444   dpyinfo = check_ns_display_info (display);
2445   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2446   return make_number (1 << min (dpyinfo->n_planes, 24));
2450 /* Unused dummy def needed for compatibility. */
2451 Lisp_Object tip_frame;
2453 /* TODO: move to xdisp or similar */
2454 static void
2455 compute_tip_xy (struct frame *f,
2456                 Lisp_Object parms,
2457                 Lisp_Object dx,
2458                 Lisp_Object dy,
2459                 int width,
2460                 int height,
2461                 int *root_x,
2462                 int *root_y)
2464   Lisp_Object left, top;
2465   EmacsView *view = FRAME_NS_VIEW (f);
2466   NSPoint pt;
2468   /* Start with user-specified or mouse position.  */
2469   left = Fcdr (Fassq (Qleft, parms));
2470   top = Fcdr (Fassq (Qtop, parms));
2472   if (!INTEGERP (left) || !INTEGERP (top))
2473     {
2474       pt = last_mouse_motion_position;
2475       /* Convert to screen coordinates */
2476       pt = [view convertPoint: pt toView: nil];
2477       pt = [[view window] convertBaseToScreen: pt];
2478     }
2479   else
2480     {
2481       /* Absolute coordinates.  */
2482       pt.x = XINT (left);
2483       pt.y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - XINT (top)
2484         - height;
2485     }
2487   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2488   if (INTEGERP (left))
2489     *root_x = pt.x;
2490   else if (pt.x + XINT (dx) <= 0)
2491     *root_x = 0; /* Can happen for negative dx */
2492   else if (pt.x + XINT (dx) + width
2493            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2494     /* It fits to the right of the pointer.  */
2495     *root_x = pt.x + XINT (dx);
2496   else if (width + XINT (dx) <= pt.x)
2497     /* It fits to the left of the pointer.  */
2498     *root_x = pt.x - width - XINT (dx);
2499   else
2500     /* Put it left justified on the screen -- it ought to fit that way.  */
2501     *root_x = 0;
2503   if (INTEGERP (top))
2504     *root_y = pt.y;
2505   else if (pt.y - XINT (dy) - height >= 0)
2506     /* It fits below the pointer.  */
2507     *root_y = pt.y - height - XINT (dy);
2508   else if (pt.y + XINT (dy) + height
2509            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2510     /* It fits above the pointer */
2511       *root_y = pt.y + XINT (dy);
2512   else
2513     /* Put it on the top.  */
2514     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2518 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2519        doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2520 A tooltip window is a small window displaying a string.
2522 This is an internal function; Lisp code should call `tooltip-show'.
2524 FRAME nil or omitted means use the selected frame.
2526 PARMS is an optional list of frame parameters which can be used to
2527 change the tooltip's appearance.
2529 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2530 means use the default timeout of 5 seconds.
2532 If the list of frame parameters PARMS contains a `left' parameter,
2533 the tooltip is displayed at that x-position.  Otherwise it is
2534 displayed at the mouse position, with offset DX added (default is 5 if
2535 DX isn't specified).  Likewise for the y-position; if a `top' frame
2536 parameter is specified, it determines the y-position of the tooltip
2537 window, otherwise it is displayed at the mouse position, with offset
2538 DY added (default is -10).
2540 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2541 Text larger than the specified size is clipped.  */)
2542      (Lisp_Object string, Lisp_Object frame, Lisp_Object parms, Lisp_Object timeout, Lisp_Object dx, Lisp_Object dy)
2544   int root_x, root_y;
2545   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2546   ptrdiff_t count = SPECPDL_INDEX ();
2547   struct frame *f;
2548   char *str;
2549   NSSize size;
2551   specbind (Qinhibit_redisplay, Qt);
2553   GCPRO4 (string, parms, frame, timeout);
2555   CHECK_STRING (string);
2556   str = SSDATA (string);
2557   f = check_x_frame (frame);
2558   if (NILP (timeout))
2559     timeout = make_number (5);
2560   else
2561     CHECK_NATNUM (timeout);
2563   if (NILP (dx))
2564     dx = make_number (5);
2565   else
2566     CHECK_NUMBER (dx);
2568   if (NILP (dy))
2569     dy = make_number (-10);
2570   else
2571     CHECK_NUMBER (dy);
2573   BLOCK_INPUT;
2574   if (ns_tooltip == nil)
2575     ns_tooltip = [[EmacsTooltip alloc] init];
2576   else
2577     Fx_hide_tip ();
2579   [ns_tooltip setText: str];
2580   size = [ns_tooltip frame].size;
2582   /* Move the tooltip window where the mouse pointer is.  Resize and
2583      show it.  */
2584   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2585                   &root_x, &root_y);
2587   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2588   UNBLOCK_INPUT;
2590   UNGCPRO;
2591   return unbind_to (count, Qnil);
2595 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2596        doc: /* Hide the current tooltip window, if there is any.
2597 Value is t if tooltip was open, nil otherwise.  */)
2598      (void)
2600   if (ns_tooltip == nil || ![ns_tooltip isActive])
2601     return Qnil;
2602   [ns_tooltip hide];
2603   return Qt;
2607 /* ==========================================================================
2609     Class implementations
2611    ========================================================================== */
2614 @implementation EmacsSavePanel
2615 #ifdef NS_IMPL_COCOA
2616 /* --------------------------------------------------------------------------
2617    These are overridden to intercept on OS X: ending panel restarts NSApp
2618    event loop if it is stopped.  Not sure if this is correct behavior,
2619    perhaps should check if running and if so send an appdefined.
2620    -------------------------------------------------------------------------- */
2621 - (void) ok: (id)sender
2623   [super ok: sender];
2624   panelOK = 1;
2625   [NSApp stop: self];
2627 - (void) cancel: (id)sender
2629   [super cancel: sender];
2630   [NSApp stop: self];
2632 #endif
2633 @end
2636 @implementation EmacsOpenPanel
2637 #ifdef NS_IMPL_COCOA
2638 /* --------------------------------------------------------------------------
2639    These are overridden to intercept on OS X: ending panel restarts NSApp
2640    event loop if it is stopped.  Not sure if this is correct behavior,
2641    perhaps should check if running and if so send an appdefined.
2642    -------------------------------------------------------------------------- */
2643 - (void) ok: (id)sender
2645   [super ok: sender];
2646   panelOK = 1;
2647   [NSApp stop: self];
2649 - (void) cancel: (id)sender
2651   [super cancel: sender];
2652   [NSApp stop: self];
2654 #endif
2655 @end
2658 @implementation EmacsFileDelegate
2659 /* --------------------------------------------------------------------------
2660    Delegate methods for Open/Save panels
2661    -------------------------------------------------------------------------- */
2662 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2664   return YES;
2666 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2668   return YES;
2670 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2671           confirmed: (BOOL)okFlag
2673   return filename;
2675 @end
2677 #endif
2680 /* ==========================================================================
2682     Lisp interface declaration
2684    ========================================================================== */
2687 void
2688 syms_of_nsfns (void)
2690   Qfontsize = intern_c_string ("fontsize");
2691   staticpro (&Qfontsize);
2693   DEFVAR_LISP ("ns-icon-type-alist", Vns_icon_type_alist,
2694                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2695 If the title of a frame matches REGEXP, then IMAGE.tiff is
2696 selected as the image of the icon representing the frame when it's
2697 miniaturized.  If an element is t, then Emacs tries to select an icon
2698 based on the filetype of the visited file.
2700 The images have to be installed in a folder called English.lproj in the
2701 Emacs folder.  You have to restart Emacs after installing new icons.
2703 Example: Install an icon Gnus.tiff and execute the following code
2705   (setq ns-icon-type-alist
2706         (append ns-icon-type-alist
2707                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2708                    . \"Gnus\"))))
2710 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2711 be used as the image of the icon representing the frame.  */);
2712   Vns_icon_type_alist = Fcons (Qt, Qnil);
2714   DEFVAR_LISP ("ns-version-string", Vns_version_string,
2715                doc: /* Toolkit version for NS Windowing.  */);
2716   Vns_version_string = ns_appkit_version_str ();
2718   defsubr (&Sns_read_file_name);
2719   defsubr (&Sns_get_resource);
2720   defsubr (&Sns_set_resource);
2721   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2722   defsubr (&Sx_display_grayscale_p);
2723   defsubr (&Sns_font_name);
2724   defsubr (&Sns_list_colors);
2725 #ifdef NS_IMPL_COCOA
2726   defsubr (&Sns_do_applescript);
2727 #endif
2728   defsubr (&Sxw_color_defined_p);
2729   defsubr (&Sxw_color_values);
2730   defsubr (&Sx_server_max_request_size);
2731   defsubr (&Sx_server_vendor);
2732   defsubr (&Sx_server_version);
2733   defsubr (&Sx_display_pixel_width);
2734   defsubr (&Sx_display_pixel_height);
2735   defsubr (&Sns_display_usable_bounds);
2736   defsubr (&Sx_display_mm_width);
2737   defsubr (&Sx_display_mm_height);
2738   defsubr (&Sx_display_screens);
2739   defsubr (&Sx_display_planes);
2740   defsubr (&Sx_display_color_cells);
2741   defsubr (&Sx_display_visual_class);
2742   defsubr (&Sx_display_backing_store);
2743   defsubr (&Sx_display_save_under);
2744   defsubr (&Sx_create_frame);
2745   defsubr (&Sx_open_connection);
2746   defsubr (&Sx_close_connection);
2747   defsubr (&Sx_display_list);
2749   defsubr (&Sns_hide_others);
2750   defsubr (&Sns_hide_emacs);
2751   defsubr (&Sns_emacs_info_panel);
2752   defsubr (&Sns_list_services);
2753   defsubr (&Sns_perform_service);
2754   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2755   defsubr (&Sx_focus_frame);
2756   defsubr (&Sns_popup_font_panel);
2757   defsubr (&Sns_popup_color_panel);
2759   defsubr (&Sx_show_tip);
2760   defsubr (&Sx_hide_tip);
2762   /* used only in fontset.c */
2763   check_window_system_func = check_ns;
2765   as_status = 0;
2766   as_script = Qnil;
2767   as_result = 0;