* lispref/modes.texi (Region to Refontify): Rename from "Region to Fontify".
[emacs.git] / src / nsfns.m
blob64d3bbfbcd07cef429204da73a5ff29c0eeac2fd
1 /* Functions for the NeXT/Open/GNUstep and MacOSX window system.
2    Copyright (C) 1989, 1992, 1993, 1994, 2005, 2006, 2008, 2009, 2010, 2011
3      Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
21 Originally by Carl Edman
22 Updated by Christian Limpach (chris@nice.ch)
23 OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com)
24 MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net)
25 GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu)
28 /* This should be the first include, as it may set up #defines affecting
29    interpretation of even the system includes. */
30 #include "config.h"
32 #include <signal.h>
33 #include <math.h>
34 #include <setjmp.h>
36 #include "lisp.h"
37 #include "blockinput.h"
38 #include "nsterm.h"
39 #include "window.h"
40 #include "buffer.h"
41 #include "keyboard.h"
42 #include "termhooks.h"
43 #include "fontset.h"
44 #include "character.h"
45 #include "font.h"
47 #if 0
48 int fns_trace_num = 1;
49 #define NSTRACE(x)        fprintf (stderr, "%s:%d: [%d] " #x "\n",        \
50                                   __FILE__, __LINE__, ++fns_trace_num)
51 #else
52 #define NSTRACE(x)
53 #endif
55 #ifdef HAVE_NS
57 extern NSArray *ns_send_types, *ns_return_types, *ns_drag_types;
59 extern Lisp_Object Qforeground_color;
60 extern Lisp_Object Qbackground_color;
61 extern Lisp_Object Qcursor_color;
62 extern Lisp_Object Qinternal_border_width;
63 extern Lisp_Object Qvisibility;
64 extern Lisp_Object Qcursor_type;
65 extern Lisp_Object Qicon_type;
66 extern Lisp_Object Qicon_name;
67 extern Lisp_Object Qicon_left;
68 extern Lisp_Object Qicon_top;
69 extern Lisp_Object Qleft;
70 extern Lisp_Object Qright;
71 extern Lisp_Object Qtop;
72 extern Lisp_Object Qdisplay;
73 extern Lisp_Object Qvertical_scroll_bars;
74 extern Lisp_Object Qauto_raise;
75 extern Lisp_Object Qauto_lower;
76 extern Lisp_Object Qbox;
77 extern Lisp_Object Qscroll_bar_width;
78 extern Lisp_Object Qx_resource_name;
79 extern Lisp_Object Qface_set_after_frame_default;
80 extern Lisp_Object Qunderline, Qundefined;
81 extern Lisp_Object Qheight, Qminibuffer, Qname, Qonly, Qwidth;
82 extern Lisp_Object Qunsplittable, Qmenu_bar_lines, Qbuffer_predicate, Qtitle;
83 extern Lisp_Object Qnone;
84 extern Lisp_Object Vframe_title_format, Vicon_title_format;
86 Lisp_Object Qbuffered;
87 Lisp_Object Qfontsize;
89 /* hack for OS X file panels */
90 char panelOK = 0;
92 /* Alist of elements (REGEXP . IMAGE) for images of icons associated
93    to frames.*/
94 static Lisp_Object Vns_icon_type_alist;
96 /* Toolkit version support. */
97 static Lisp_Object Vns_version_string;
99 EmacsTooltip *ns_tooltip;
101 /* Need forward declaration here to preserve organizational integrity of file */
102 Lisp_Object Fx_open_connection (Lisp_Object, Lisp_Object, Lisp_Object);
104 extern BOOL ns_in_resize;
107 /* ==========================================================================
109     Internal utility functions
111    ========================================================================== */
114 void
115 check_ns (void)
117  if (NSApp == nil)
118    error ("OpenStep is not in use or not initialized");
122 /* Nonzero if we can use mouse menus. */
124 have_menus_p ()
126   return NSApp != nil;
130 /* Extract a frame as a FRAME_PTR, defaulting to the selected frame
131    and checking validity for NS.  */
132 static FRAME_PTR
133 check_ns_frame (Lisp_Object frame)
135   FRAME_PTR f;
137   if (NILP (frame))
138       f = SELECTED_FRAME ();
139   else
140     {
141       CHECK_LIVE_FRAME (frame);
142       f = XFRAME (frame);
143     }
144   if (! FRAME_NS_P (f))
145     error ("non-Nextstep frame used");
146   return f;
150 /* Let the user specify an Nextstep display with a frame.
151    nil stands for the selected frame--or, if that is not an Nextstep frame,
152    the first Nextstep display on the list.  */
153 static struct ns_display_info *
154 check_ns_display_info (Lisp_Object frame)
156   if (NILP (frame))
157     {
158       struct frame *f = SELECTED_FRAME ();
159       if (FRAME_NS_P (f) && FRAME_LIVE_P (f) )
160         return FRAME_NS_DISPLAY_INFO (f);
161       else if (x_display_list != 0)
162         return x_display_list;
163       else
164         error ("Nextstep windows are not in use or not initialized");
165     }
166   else if (INTEGERP (frame))
167     {
168       struct terminal *t = get_terminal (frame, 1);
170       if (t->type != output_ns)
171         error ("Terminal %d is not a Nextstep display", XINT (frame));
173       return t->display_info.ns;
174     }
175   else if (STRINGP (frame))
176     return ns_display_info_for_name (frame);
177   else
178     {
179       FRAME_PTR f;
181       CHECK_LIVE_FRAME (frame);
182       f = XFRAME (frame);
183       if (! FRAME_NS_P (f))
184         error ("non-Nextstep frame used");
185       return FRAME_NS_DISPLAY_INFO (f);
186     }
187   return NULL;  /* shut compiler up */
191 static id
192 ns_get_window (Lisp_Object maybeFrame)
194   id view =nil, window =nil;
196   if (!FRAMEP (maybeFrame) || !FRAME_NS_P (XFRAME (maybeFrame)))
197     maybeFrame = selected_frame;/*wrong_type_argument (Qframep, maybeFrame); */
199   if (!NILP (maybeFrame))
200     view = FRAME_NS_VIEW (XFRAME (maybeFrame));
201   if (view) window =[view window];
203   return window;
207 static NSScreen *
208 ns_get_screen (Lisp_Object screen)
210   struct frame *f;
211   struct terminal *terminal;
213   if (EQ (Qt, screen)) /* not documented */
214     return [NSScreen mainScreen];
216   terminal = get_terminal (screen, 1);
217   if (terminal->type != output_ns)
218     return NULL;
220   if (NILP (screen))
221     f = SELECTED_FRAME ();
222   else if (FRAMEP (screen))
223     f = XFRAME (screen);
224   else
225     {
226       struct ns_display_info *dpyinfo = terminal->display_info.ns;
227       f = dpyinfo->x_focus_frame 
228         ? dpyinfo->x_focus_frame : dpyinfo->x_highlight_frame;
229     }
231   return ((f && FRAME_NS_P (f)) ? [[FRAME_NS_VIEW (f) window] screen]
232           : NULL);
236 /* Return the X display structure for the display named NAME.
237    Open a new connection if necessary.  */
238 struct ns_display_info *
239 ns_display_info_for_name (name)
240      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;
332   if (ns_lisp_to_color (arg, &col))
333     {
334       store_frame_param (f, Qforeground_color, oldval);
335       error ("Unknown color");
336     }
338   [col retain];
339   [f->output_data.ns->foreground_color release];
340   f->output_data.ns->foreground_color = col;
342   if (FRAME_NS_VIEW (f))
343     {
344       update_face_from_frame_parameter (f, Qforeground_color, arg);
345       /*recompute_basic_faces (f); */
346       if (FRAME_VISIBLE_P (f))
347         redraw_frame (f);
348     }
352 static void
353 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
355   struct face *face;
356   NSColor *col;
357   NSView *view = FRAME_NS_VIEW (f);
358   float alpha;
360   if (ns_lisp_to_color (arg, &col))
361     {
362       store_frame_param (f, Qbackground_color, oldval);
363       error ("Unknown color");
364     }
366   /* clear the frame; in some instances the NS-internal GC appears not to
367      update, or it does update and cannot clear old text properly */
368   if (FRAME_VISIBLE_P (f))
369     ns_clear_frame (f);
371   [col retain];
372   [f->output_data.ns->background_color release];
373   f->output_data.ns->background_color = col;
374   if (view != nil)
375     {
376       [[view window] setBackgroundColor: col];
377       alpha = [col alphaComponent];
379       if (alpha != 1.0)
380           [[view window] setOpaque: NO];
381       else
382           [[view window] setOpaque: YES];
384       face = FRAME_DEFAULT_FACE (f);
385       if (face)
386         {
387           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
388           face->background
389              = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
390           [col release];
392           update_face_from_frame_parameter (f, Qbackground_color, arg);
393         }
395       if (FRAME_VISIBLE_P (f))
396         redraw_frame (f);
397     }
401 static void
402 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
404   NSColor *col;
406   if (ns_lisp_to_color (arg, &col))
407     {
408       store_frame_param (f, Qcursor_color, oldval);
409       error ("Unknown color");
410     }
412   [FRAME_CURSOR_COLOR (f) release];
413   FRAME_CURSOR_COLOR (f) = [col retain];
415   if (FRAME_VISIBLE_P (f))
416     {
417       x_update_cursor (f, 0);
418       x_update_cursor (f, 1);
419     }
420   update_face_from_frame_parameter (f, Qcursor_color, arg);
424 static void
425 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
427   NSView *view = FRAME_NS_VIEW (f);
428   NSTRACE (x_set_icon_name);
430   if (ns_in_resize)
431     return;
433   /* see if it's changed */
434   if (STRINGP (arg))
435     {
436       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
437         return;
438     }
439   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
440     return;
442   f->icon_name = arg;
444   if (NILP (arg))
445     {
446       if (!NILP (f->title))
447         arg = f->title;
448       else
449         /* explicit name and no icon-name -> explicit_name */
450         if (f->explicit_name)
451           arg = f->name;
452         else
453           {
454             /* no explicit name and no icon-name ->
455                name has to be rebuild from icon_title_format */
456             windows_or_buffers_changed++;
457             return;
458           }
459     }
461   /* Don't change the name if it's already NAME.  */
462   if ([[view window] miniwindowTitle] &&
463       ([[[view window] miniwindowTitle]
464              isEqualToString: [NSString stringWithUTF8String:
465                                            SDATA (arg)]]))
466     return;
468   [[view window] setMiniwindowTitle:
469         [NSString stringWithUTF8String: SDATA (arg)]];
472 static void
473 ns_set_name_internal (FRAME_PTR f, Lisp_Object name)
475   struct gcpro gcpro1;
476   Lisp_Object encoded_name, encoded_icon_name;
477   NSString *str;
478   NSView *view = FRAME_NS_VIEW (f);
480   GCPRO1 (name);
481   encoded_name = ENCODE_UTF_8 (name);
482   UNGCPRO;
484   str = [NSString stringWithUTF8String: SDATA (encoded_name)];
486   /* Don't change the name if it's already NAME.  */
487   if (! [[[view window] title] isEqualToString: str])
488     [[view window] setTitle: str];
490   if (!STRINGP (f->icon_name))
491     encoded_icon_name = encoded_name;
492   else
493     encoded_icon_name = ENCODE_UTF_8 (f->icon_name);    
495   str = [NSString stringWithUTF8String: SDATA (encoded_icon_name)];
497   if ([[view window] miniwindowTitle] &&
498       ! [[[view window] miniwindowTitle] isEqualToString: str])
499     [[view window] setMiniwindowTitle: str];
503 static void
504 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
506   NSView *view;
507   NSTRACE (ns_set_name);
509   if (ns_in_resize)
510     return;
512   /* Make sure that requests from lisp code override requests from
513      Emacs redisplay code.  */
514   if (explicit)
515     {
516       /* If we're switching from explicit to implicit, we had better
517          update the mode lines and thereby update the title.  */
518       if (f->explicit_name && NILP (name))
519         update_mode_lines = 1;
521       f->explicit_name = ! NILP (name);
522     }
523   else if (f->explicit_name)
524     return;
526   if (NILP (name))
527     name = build_string([ns_app_name UTF8String]);
528   else
529     CHECK_STRING (name);
531   /* Don't change the name if it's already NAME.  */
532   if (! NILP (Fstring_equal (name, f->name)))
533     return;
535   f->name = name;
537   /* title overrides explicit name */
538   if (! NILP (f->title))
539     name = f->title;
541   ns_set_name_internal (f, name);
545 /* This function should be called when the user's lisp code has
546    specified a name for the frame; the name will override any set by the
547    redisplay code.  */
548 static void
549 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
551   NSTRACE (x_explicitly_set_name);
552   ns_set_name (f, arg, 1);
556 /* This function should be called by Emacs redisplay code to set the
557    name; names set this way will never override names set by the user's
558    lisp code.  */
559 void
560 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
562   NSTRACE (x_implicitly_set_name);
564   /* Deal with NS specific format t.  */
565   if (FRAME_NS_P (f) && ((FRAME_ICONIFIED_P (f) && EQ (Vicon_title_format, Qt))
566                          || EQ (Vframe_title_format, Qt)))
567     ns_set_name_as_filename (f);
568   else
569     ns_set_name (f, arg, 0);
573 /* Change the title of frame F to NAME.
574    If NAME is nil, use the frame name as the title.  */
576 static void
577 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
579   NSTRACE (x_set_title);
580   /* Don't change the title if it's already NAME.  */
581   if (EQ (name, f->title))
582     return;
584   update_mode_lines = 1;
586   f->title = name;
588   if (NILP (name))
589     name = f->name;
590   else
591     CHECK_STRING (name);
593   ns_set_name_internal (f, name);
597 void
598 ns_set_name_as_filename (struct frame *f)
600   NSView *view;
601   Lisp_Object name, filename;
602   Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
603   const char *title;
604   NSAutoreleasePool *pool;
605   struct gcpro gcpro1;
606   Lisp_Object encoded_name, encoded_filename;
607   NSString *str;
608   NSTRACE (ns_set_name_as_filename);
610   if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
611     return;
613   BLOCK_INPUT;
614   pool = [[NSAutoreleasePool alloc] init];
615   filename = XBUFFER (buf)->filename;
616   name = XBUFFER (buf)->name;
618   if (NILP (name))
619     {
620       if (! NILP (filename))
621         name = Ffile_name_nondirectory (filename);
622       else
623         name = build_string ([ns_app_name UTF8String]);
624     }
626   GCPRO1 (name);
627   encoded_name = ENCODE_UTF_8 (name);
628   UNGCPRO;
630   view = FRAME_NS_VIEW (f);
632   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
633                                 : [[[view window] title] UTF8String];
635   if (title && (! strcmp (title, SDATA (encoded_name))))
636     {
637       [pool release];
638       UNBLOCK_INPUT;
639       return;
640     }
642   str = [NSString stringWithUTF8String: SDATA (encoded_name)];
643   if (str == nil) str = @"Bad coding";
645   if (FRAME_ICONIFIED_P (f))
646     [[view window] setMiniwindowTitle: str];
647   else 
648     {
649       NSString *fstr;
651       if (! NILP (filename))
652         {
653           GCPRO1 (filename);
654           encoded_filename = ENCODE_UTF_8 (filename);
655           UNGCPRO;
657           fstr = [NSString stringWithUTF8String: SDATA (encoded_filename)];
658           if (fstr == nil) fstr = @"";
659 #ifdef NS_IMPL_COCOA
660           /* work around a bug observed on 10.3 and later where
661              setTitleWithRepresentedFilename does not clear out previous state
662              if given filename does not exist */
663           if (! [[NSFileManager defaultManager] fileExistsAtPath: fstr])
664             [[view window] setRepresentedFilename: @""];
665 #endif
666         }
667       else
668         fstr = @"";
670       [[view window] setRepresentedFilename: fstr];
671       [[view window] setTitle: str];
672       f->name = name;
673     }
675   [pool release];
676   UNBLOCK_INPUT;
680 void
681 ns_set_doc_edited (struct frame *f, Lisp_Object arg)
683   NSView *view = FRAME_NS_VIEW (f);
684   NSAutoreleasePool *pool;
685   if (!MINI_WINDOW_P (XWINDOW (f->selected_window)))
686     {
687       BLOCK_INPUT;
688       pool = [[NSAutoreleasePool alloc] init];
689       [[view window] setDocumentEdited: !NILP (arg)];
690       [pool release];
691       UNBLOCK_INPUT;
692     }
696 void
697 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
699   int nlines;
700   int olines = FRAME_MENU_BAR_LINES (f);
701   if (FRAME_MINIBUF_ONLY_P (f))
702     return;
704   if (INTEGERP (value))
705     nlines = XINT (value);
706   else
707     nlines = 0;
709   FRAME_MENU_BAR_LINES (f) = 0;
710   if (nlines)
711     {
712       FRAME_EXTERNAL_MENU_BAR (f) = 1;
713       /* does for all frames, whereas we just want for one frame
714          [NSMenu setMenuBarVisible: YES]; */
715     }
716   else
717     {
718       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
719         free_frame_menubar (f);
720       /*      [NSMenu setMenuBarVisible: NO]; */
721       FRAME_EXTERNAL_MENU_BAR (f) = 0;
722     }
726 /* toolbar support */
727 void
728 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
730   int nlines;
731   Lisp_Object root_window;
733   if (FRAME_MINIBUF_ONLY_P (f))
734     return;
736   if (INTEGERP (value) && XINT (value) >= 0)
737     nlines = XFASTINT (value);
738   else
739     nlines = 0;
741   if (nlines)
742     {
743       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
744       update_frame_tool_bar (f);
745     }
746   else
747     {
748       if (FRAME_EXTERNAL_TOOL_BAR (f))
749         {
750           free_frame_tool_bar (f);
751           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
752         }
753     }
755   x_set_window_size (f, 0, f->text_cols, f->text_lines);
759 void
760 ns_implicitly_set_icon_type (struct frame *f)
762   Lisp_Object tem;
763   EmacsView *view = FRAME_NS_VIEW (f);
764   id image =nil;
765   Lisp_Object chain, elt;
766   NSAutoreleasePool *pool;
767   BOOL setMini = YES;
769   NSTRACE (ns_implicitly_set_icon_type);
771   BLOCK_INPUT;
772   pool = [[NSAutoreleasePool alloc] init];
773   if (f->output_data.ns->miniimage
774       && [[NSString stringWithUTF8String: SDATA (f->name)]
775                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
776     {
777       [pool release];
778       UNBLOCK_INPUT;
779       return;
780     }
782   tem = assq_no_quit (Qicon_type, f->param_alist);
783   if (CONSP (tem) && ! NILP (XCDR (tem)))
784     {
785       [pool release];
786       UNBLOCK_INPUT;
787       return;
788     }
790   for (chain = Vns_icon_type_alist;
791        (image = nil) && CONSP (chain);
792        chain = XCDR (chain))
793     {
794       elt = XCAR (chain);
795       /* special case: 't' means go by file type */
796       if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
797         {
798           NSString *str
799              = [NSString stringWithUTF8String: SDATA (f->name)];
800           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
801             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
802         }
803       else if (CONSP (elt) &&
804                STRINGP (XCAR (elt)) &&
805                STRINGP (XCDR (elt)) &&
806                fast_string_match (XCAR (elt), f->name) >= 0)
807         {
808           image = [EmacsImage allocInitFromFile: XCDR (elt)];
809           if (image == nil)
810             image = [[NSImage imageNamed:
811                                [NSString stringWithUTF8String:
812                                             SDATA (XCDR (elt))]] retain];
813         }
814     }
816   if (image == nil)
817     {
818       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
819       setMini = NO;
820     }
822   [f->output_data.ns->miniimage release];
823   f->output_data.ns->miniimage = image;
824   [view setMiniwindowImage: setMini];
825   [pool release];
826   UNBLOCK_INPUT;
830 static void
831 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
833   EmacsView *view = FRAME_NS_VIEW (f);
834   id image = nil;
835   BOOL setMini = YES;
837   NSTRACE (x_set_icon_type);
839   if (!NILP (arg) && SYMBOLP (arg))
840     {
841       arg =build_string (SDATA (SYMBOL_NAME (arg)));
842       store_frame_param (f, Qicon_type, arg);
843     }
845   /* do it the implicit way */
846   if (NILP (arg))
847     {
848       ns_implicitly_set_icon_type (f);
849       return;
850     }
852   CHECK_STRING (arg);
854   image = [EmacsImage allocInitFromFile: arg];
855   if (image == nil)
856     image =[NSImage imageNamed: [NSString stringWithUTF8String:
857                                             SDATA (arg)]];
859   if (image == nil)
860     {
861       image = [NSImage imageNamed: @"text"];
862       setMini = NO;
863     }
865   f->output_data.ns->miniimage = image;
866   [view setMiniwindowImage: setMini];
870 /* Xism; we stub out (we do implement this in ns-win.el) */
872 XParseGeometry (char *string, int *x, int *y,
873                 unsigned int *width, unsigned int *height)
875   message1 ("Warning: XParseGeometry not supported under NS.\n");
876   return 0;
880 /* TODO: move to nsterm? */
882 ns_lisp_to_cursor_type (Lisp_Object arg)
884   char *str;
885   if (XTYPE (arg) == Lisp_String)
886     str = SDATA (arg);
887   else if (XTYPE (arg) == Lisp_Symbol)
888     str = SDATA (SYMBOL_NAME (arg));
889   else return -1;
890   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
891   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
892   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
893   if (!strcmp (str, "bar"))     return BAR_CURSOR;
894   if (!strcmp (str, "no"))      return NO_CURSOR;
895   return -1;
899 Lisp_Object
900 ns_cursor_type_to_lisp (int arg)
902   switch (arg)
903     {
904     case FILLED_BOX_CURSOR: return Qbox;
905     case HOLLOW_BOX_CURSOR: return intern ("hollow");
906     case HBAR_CURSOR:       return intern ("hbar");
907     case BAR_CURSOR:        return intern ("bar");
908     case NO_CURSOR:
909     default:                return intern ("no");
910     }
913 /* This is the same as the xfns.c definition.  */
914 void
915 x_set_cursor_type (f, arg, oldval)
916      FRAME_PTR f;
917      Lisp_Object arg, oldval;
919   set_frame_cursor_types (f, arg);
921   /* Make sure the cursor gets redrawn.  */
922   cursor_type_changed = 1;
926 /* called to set mouse pointer color, but all other terms use it to
927    initialize pointer types (and don't set the color ;) */
928 static void
929 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
931   /* don't think we can do this on Nextstep */
935 #define Str(x) #x
936 #define Xstr(x) Str(x)
938 static Lisp_Object
939 ns_appkit_version_str ()
941   char tmp[80];
943 #ifdef NS_IMPL_GNUSTEP
944   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
945 #elif defined(NS_IMPL_COCOA)
946   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
947 #else
948   tmp = "ns-unknown";
949 #endif
950   return build_string (tmp);
954 /* This is for use by x-server-version and collapses all version info we
955    have into a single int.  For a better picture of the implementation
956    running, use ns_appkit_version_str.*/
957 static int
958 ns_appkit_version_int ()
960 #ifdef NS_IMPL_GNUSTEP
961   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GUI_MINOR_VERSION;
962 #elif defined(NS_IMPL_COCOA)
963   return (int)NSAppKitVersionNumber;
964 #endif
965   return 0;
969 static void
970 x_icon (struct frame *f, Lisp_Object parms)
971 /* --------------------------------------------------------------------------
972    Strangely-named function to set icon position parameters in frame.
973    This is irrelevant under OS X, but might be needed under GNUstep,
974    depending on the window manager used.  Note, this is not a standard
975    frame parameter-setter; it is called directly from x-create-frame.
976    -------------------------------------------------------------------------- */
978   Lisp_Object icon_x, icon_y;
979   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
981   f->output_data.ns->icon_top = Qnil;
982   f->output_data.ns->icon_left = Qnil;
984   /* Set the position of the icon.  */
985   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
986   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
987   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
988     {
989       CHECK_NUMBER (icon_x);
990       CHECK_NUMBER (icon_y);
991       f->output_data.ns->icon_top = icon_y;
992       f->output_data.ns->icon_left = icon_x;
993     }
994   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
995     error ("Both left and top icon corners of icon must be specified");
999 /* Note: see frame.c for template, also where generic functions are impl */
1000 frame_parm_handler ns_frame_parm_handlers[] =
1002   x_set_autoraise, /* generic OK */
1003   x_set_autolower, /* generic OK */
1004   x_set_background_color,
1005   0, /* x_set_border_color,  may be impossible under Nextstep */
1006   0, /* x_set_border_width,  may be impossible under Nextstep */
1007   x_set_cursor_color,
1008   x_set_cursor_type,
1009   x_set_font, /* generic OK */
1010   x_set_foreground_color,
1011   x_set_icon_name,
1012   x_set_icon_type,
1013   x_set_internal_border_width, /* generic OK */
1014   x_set_menu_bar_lines,
1015   x_set_mouse_color,
1016   x_explicitly_set_name,
1017   x_set_scroll_bar_width, /* generic OK */
1018   x_set_title,
1019   x_set_unsplittable, /* generic OK */
1020   x_set_vertical_scroll_bars, /* generic OK */
1021   x_set_visibility, /* generic OK */
1022   x_set_tool_bar_lines,
1023   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1024   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
1025   x_set_screen_gamma, /* generic OK */
1026   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1027   x_set_fringe_width, /* generic OK */
1028   x_set_fringe_width, /* generic OK */
1029   0, /* x_set_wait_for_wm, will ignore */
1030   0,  /* x_set_fullscreen will ignore */
1031   x_set_font_backend, /* generic OK */
1032   x_set_alpha,
1033   0, /* x_set_sticky */  
1038 /* ==========================================================================
1040     Lisp definitions
1042    ========================================================================== */
1044 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1045        1, 1, 0,
1046        doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1047 Return an Emacs frame object.
1048 PARMS is an alist of frame parameters.
1049 If the parameters specify that the frame should not have a minibuffer,
1050 and do not specify a specific minibuffer window to use,
1051 then `default-minibuffer-frame' must be a frame whose minibuffer can
1052 be shared by the new frame.  */)
1053      (parms)
1054      Lisp_Object parms;
1056   static int desc_ctr = 1;
1057   struct frame *f;
1058   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1059   Lisp_Object frame, tem;
1060   Lisp_Object name;
1061   int minibuffer_only = 0;
1062   int count = specpdl_ptr - specpdl;
1063   Lisp_Object display;
1064   struct ns_display_info *dpyinfo = NULL;
1065   Lisp_Object parent;
1066   struct kboard *kb;
1067   Lisp_Object tfont, tfontsize;
1068   int window_prompting = 0;
1069   int width, height;
1071   check_ns ();
1073   /* Seems a little strange, but other terms do it. Perhaps the code below
1074      is modifying something? */
1075   parms = Fcopy_alist (parms);
1077   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1078   if (EQ (display, Qunbound))
1079     display = Qnil;
1080   dpyinfo = check_ns_display_info (display);
1082   if (!dpyinfo->terminal->name)
1083     error ("Terminal is not live, can't create new frames on it");
1085   kb = dpyinfo->terminal->kboard;
1087   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1088   if (!STRINGP (name)
1089       && ! EQ (name, Qunbound)
1090       && ! NILP (name))
1091     error ("Invalid frame name--not a string or nil");
1093   if (STRINGP (name))
1094     Vx_resource_name = name;
1095   else
1096     Vx_resource_name = Vinvocation_name;
1098   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1099   if (EQ (parent, Qunbound))
1100     parent = Qnil;
1101   if (! NILP (parent))
1102     CHECK_NUMBER (parent);
1104   frame = Qnil;
1105   GCPRO4 (parms, parent, name, frame);
1107   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1108                   RES_TYPE_SYMBOL);
1109   if (EQ (tem, Qnone) || NILP (tem))
1110     {
1111       f = make_frame_without_minibuffer (Qnil, kb, display);
1112     }
1113   else if (EQ (tem, Qonly))
1114     {
1115       f = make_minibuffer_frame ();
1116       minibuffer_only = 1;
1117     }
1118   else if (WINDOWP (tem))
1119     {
1120       f = make_frame_without_minibuffer (tem, kb, display);
1121     }
1122   else
1123     {
1124       f = make_frame (1);
1125     }
1127   /* Set the name; the functions to which we pass f expect the name to
1128      be set.  */
1129   if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1130     {
1131       f->name = build_string ([ns_app_name UTF8String]);
1132       f->explicit_name =0;
1133     }
1134   else
1135     {
1136       f->name = name;
1137       f->explicit_name = 1;
1138       specbind (Qx_resource_name, name);
1139     }
1141   XSETFRAME (frame, f);
1142   FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1144   f->terminal = dpyinfo->terminal;
1145   f->terminal->reference_count++;
1147   f->output_method = output_ns;
1148   f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1149   bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1151   FRAME_FONTSET (f) = -1;
1153   /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1155   f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1156                             RES_TYPE_STRING);
1157   if (! STRINGP (f->icon_name))
1158     f->icon_name = Qnil;
1160   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1162   f->output_data.ns->window_desc = desc_ctr++;
1163   if (!NILP (parent))
1164     {
1165       f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1166       f->output_data.ns->explicit_parent = 1;
1167     }
1168   else
1169     {
1170       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1171       f->output_data.ns->explicit_parent = 0;
1172     }
1174   f->resx = dpyinfo->resx;
1175   f->resy = dpyinfo->resy;
1177   BLOCK_INPUT;
1178   register_font_driver (&nsfont_driver, f);
1179   x_default_parameter (f, parms, Qfont_backend, Qnil,
1180                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1182   {
1183     /* use for default font name */
1184     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1185     tfontsize = x_default_parameter (f, parms, Qfontsize,
1186                                     make_number (0 /*(int)[font pointSize]*/),
1187                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1188     tfont = x_default_parameter (f, parms, Qfont,
1189                                  build_string ([[font fontName] UTF8String]),
1190                                  "font", "Font", RES_TYPE_STRING);
1191   }
1192   UNBLOCK_INPUT;
1194   x_default_parameter (f, parms, Qborder_width, make_number (0),
1195                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1196   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1197                       "internalBorderWidth", "InternalBorderWidth",
1198                       RES_TYPE_NUMBER);
1200   /* default scrollbars on right on Mac */
1201   {
1202       Lisp_Object spos
1203 #ifdef NS_IMPL_GNUSTEP
1204           = Qt;
1205 #else
1206           = Qright;
1207 #endif
1208       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1209                            "verticalScrollBars", "VerticalScrollBars",
1210                            RES_TYPE_SYMBOL);
1211   }
1212   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1213                       "foreground", "Foreground", RES_TYPE_STRING);
1214   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1215                       "background", "Background", RES_TYPE_STRING);
1216   x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1217                       "cursorColor", "CursorColor", RES_TYPE_STRING);
1218   /* FIXME: not suppported yet in Nextstep */
1219   x_default_parameter (f, parms, Qline_spacing, Qnil,
1220                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1221   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1222                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1223   x_default_parameter (f, parms, Qright_fringe, Qnil,
1224                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1225   /* end PENDING */
1227   init_frame_faces (f);
1229   x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1230                       "menuBar", RES_TYPE_NUMBER);
1231   x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1232                       "toolBar", RES_TYPE_NUMBER);
1233   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1234                        "BufferPredicate", RES_TYPE_SYMBOL);
1235   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1236                        RES_TYPE_STRING);
1238 /* TODO: other terms seem to get away w/o this complexity.. */
1239   if (NILP (Fassq (Qwidth, parms)))
1240     {
1241       Lisp_Object value
1242          = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1243                       RES_TYPE_NUMBER);
1244       if (! EQ (value, Qunbound))
1245         parms = Fcons (Fcons (Qwidth, value), parms);
1246     }
1247   if (NILP (Fassq (Qheight, parms)))
1248     {
1249       Lisp_Object value
1250          = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1251                       RES_TYPE_NUMBER);
1252       if (! EQ (value, Qunbound))
1253         parms = Fcons (Fcons (Qheight, value), parms);
1254     }
1255   if (NILP (Fassq (Qleft, parms)))
1256     {
1257       Lisp_Object value
1258          = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1259       if (! EQ (value, Qunbound))
1260         parms = Fcons (Fcons (Qleft, value), parms);
1261     }
1262   if (NILP (Fassq (Qtop, parms)))
1263     {
1264       Lisp_Object value
1265          = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1266       if (! EQ (value, Qunbound))
1267         parms = Fcons (Fcons (Qtop, value), parms);
1268     }
1270   window_prompting = x_figure_window_size (f, parms, 1);
1272   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1273   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1275   /* NOTE: on other terms, this is done in set_mouse_color, however this
1276      was not getting called under Nextstep */
1277   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1278   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1279   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1280   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1281   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1282   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1283   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1284      = [NSCursor arrowCursor];
1285   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1287   [[EmacsView alloc] initFrameFromEmacs: f];
1289   x_icon (f, parms);
1291   /* It is now ok to make the frame official even if we get an error below.
1292      The frame needs to be on Vframe_list or making it visible won't work. */
1293   Vframe_list = Fcons (frame, Vframe_list);
1294   /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1296   x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1297                       RES_TYPE_SYMBOL);
1298   x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1299                       RES_TYPE_BOOLEAN);
1300   x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1301                       RES_TYPE_BOOLEAN);
1302   x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1303                       RES_TYPE_SYMBOL);
1304   x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1305                       "ScrollBarWidth", RES_TYPE_NUMBER);
1306   x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1307                       RES_TYPE_NUMBER);
1309   width = FRAME_COLS (f);
1310   height = FRAME_LINES (f);
1312   SET_FRAME_COLS (f, 0);
1313   FRAME_LINES (f) = 0;
1314   change_frame_size (f, height, width, 1, 0, 0);
1316   if (! f->output_data.ns->explicit_parent)
1317     {
1318       tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_SYMBOL);
1319       if (EQ (tem, Qunbound))
1320         tem = Qt;
1321       x_set_visibility (f, tem, Qnil);
1322       if (EQ (tem, Qicon))
1323         x_iconify_frame (f);
1324       else if (! NILP (tem))
1325         {
1326           x_make_frame_visible (f);
1327           f->async_visible = 1;
1328           [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1329         }
1330       else
1331           f->async_visible = 0;
1332     }
1334   if (FRAME_HAS_MINIBUF_P (f)
1335       && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1336           || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1337     kb->Vdefault_minibuffer_frame = frame;
1339   /* All remaining specified parameters, which have not been "used"
1340      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1341   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1342     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1343       f->param_alist = Fcons (XCAR (tem), f->param_alist);
1345   UNGCPRO;
1346   Vwindow_list = Qnil;
1348   return unbind_to (count, frame);
1352 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1353        doc: /* Set the input focus to FRAME.
1354 FRAME nil means use the selected frame.  */)
1355      (frame)
1356      Lisp_Object frame;
1358   struct frame *f = check_ns_frame (frame);
1359   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1361   if (dpyinfo->x_focus_frame != f)
1362     {
1363       EmacsView *view = FRAME_NS_VIEW (f);
1364       BLOCK_INPUT;
1365       [NSApp activateIgnoringOtherApps: YES];
1366       [[view window] makeKeyAndOrderFront: view];
1367       UNBLOCK_INPUT;
1368     }
1370   return Qnil;
1374 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1375        0, 1, "",
1376        doc: /* Pop up the font panel. */)
1377      (frame)
1378      Lisp_Object frame;
1380   id fm;
1381   struct frame *f;
1383   check_ns ();
1384   fm = [NSFontManager sharedFontManager];
1385   if (NILP (frame))
1386     f = SELECTED_FRAME ();
1387   else
1388     {
1389       CHECK_FRAME (frame);
1390       f = XFRAME (frame);
1391     }
1393   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1394            isMultiple: NO];
1395   [fm orderFrontFontPanel: NSApp];
1396   return Qnil;
1400 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel,
1401        0, 1, "",
1402        doc: /* Pop up the color panel.  */)
1403      (frame)
1404      Lisp_Object frame;
1406   struct frame *f;
1408   check_ns ();
1409   if (NILP (frame))
1410     f = SELECTED_FRAME ();
1411   else
1412     {
1413       CHECK_FRAME (frame);
1414       f = XFRAME (frame);
1415     }
1417   [NSApp orderFrontColorPanel: NSApp];
1418   return Qnil;
1422 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1423        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1424 Optional arg DIR, if non-nil, supplies a default directory.
1425 Optional arg MUSTMATCH, if non-nil, means the returned file or
1426 directory must exist.
1427 Optional arg INIT, if non-nil, provides a default file name to use.  */)
1428      (prompt, dir, mustmatch, init)
1429      Lisp_Object prompt, dir, mustmatch, init;
1431   static id fileDelegate = nil;
1432   int ret;
1433   id panel;
1434   Lisp_Object fname;
1436   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1437     [NSString stringWithUTF8String: SDATA (prompt)];
1438   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1439     [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1440     [NSString stringWithUTF8String: SDATA (dir)];
1441   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1442     [NSString stringWithUTF8String: SDATA (init)];
1444   check_ns ();
1446   if (fileDelegate == nil)
1447     fileDelegate = [EmacsFileDelegate new];
1449   [NSCursor setHiddenUntilMouseMoves: NO];
1451   if ([dirS characterAtIndex: 0] == '~')
1452     dirS = [dirS stringByExpandingTildeInPath];
1454   panel = NILP (mustmatch) ?
1455     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1457   [panel setTitle: promptS];
1459   /* Puma (10.1) does not have */
1460   if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1461     [panel setAllowsOtherFileTypes: YES];
1463   [panel setTreatsFilePackagesAsDirectories: YES];
1464   [panel setDelegate: fileDelegate];
1466   panelOK = 0;
1467   BLOCK_INPUT;
1468   if (NILP (mustmatch))
1469     {
1470       ret = [panel runModalForDirectory: dirS file: initS];
1471     }
1472   else
1473     {
1474       [panel setCanChooseDirectories: YES];
1475       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1476     }
1478   ret = (ret == NSOKButton) || panelOK;
1480   if (ret)
1481     fname = build_string ([[panel filename] UTF8String]);
1483   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1484   UNBLOCK_INPUT;
1486   return ret ? fname : Qnil;
1490 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1491        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1492 If OWNER is nil, Emacs is assumed.  */)
1493      (owner, name)
1494      Lisp_Object owner, name;
1496   const char *value;
1498   check_ns ();
1499   if (NILP (owner))
1500     owner = build_string([ns_app_name UTF8String]);
1501   CHECK_STRING (name);
1502 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1504   value =[[[NSUserDefaults standardUserDefaults]
1505             objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1506            UTF8String];
1508   if (value)
1509     return build_string (value);
1510   return Qnil;
1514 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1515        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1516 If OWNER is nil, Emacs is assumed.
1517 If VALUE is nil, the default is removed.  */)
1518      (owner, name, value)
1519      Lisp_Object owner, name, value;
1521   check_ns ();
1522   if (NILP (owner))
1523     owner = build_string ([ns_app_name UTF8String]);
1524   CHECK_STRING (name);
1525   if (NILP (value))
1526     {
1527       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1528                          [NSString stringWithUTF8String: SDATA (name)]];
1529     }
1530   else
1531     {
1532       CHECK_STRING (value);
1533       [[NSUserDefaults standardUserDefaults] setObject:
1534                 [NSString stringWithUTF8String: SDATA (value)]
1535                                         forKey: [NSString stringWithUTF8String:
1536                                                          SDATA (name)]];
1537     }
1539   return Qnil;
1543 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1544        Sx_server_max_request_size,
1545        0, 1, 0,
1546        doc: /* This function is a no-op.  It is only present for completeness.  */)
1547      (display)
1548      Lisp_Object display;
1550   check_ns ();
1551   /* This function has no real equivalent under NeXTstep.  Return nil to
1552      indicate this. */
1553   return Qnil;
1557 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1558        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1559 DISPLAY should be either a frame or a display name (a string).
1560 If omitted or nil, the selected frame's display is used.  */)
1561      (display)
1562      Lisp_Object display;
1564 #ifdef NS_IMPL_GNUSTEP
1565   return build_string ("GNU");
1566 #else
1567   return build_string ("Apple");
1568 #endif
1572 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1573        doc: /* Return the version numbers of the server of DISPLAY.
1574 The value is a list of three integers: the major and minor
1575 version numbers of the X Protocol in use, and the distributor-specific
1576 release number.  See also the function `x-server-vendor'.
1578 The optional argument DISPLAY specifies which display to ask about.
1579 DISPLAY should be either a frame or a display name (a string).
1580 If omitted or nil, that stands for the selected frame's display.  */)
1581      (display)
1582      Lisp_Object display;
1584   /*NOTE: it is unclear what would best correspond with "protocol";
1585           we return 10.3, meaning Panther, since this is roughly the
1586           level that GNUstep's APIs correspond to.
1587           The last number is where we distinguish between the Apple
1588           and GNUstep implementations ("distributor-specific release
1589           number") and give int'ized versions of major.minor. */
1590   return Fcons (make_number (10),
1591                 Fcons (make_number (3),
1592                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1596 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1597        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1598 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1599 If omitted or nil, the selected frame's display is used.  */)
1600      (display)
1601      Lisp_Object display;
1603   int num;
1605   check_ns ();
1606   num = [[NSScreen screens] count];
1608   return (num != 0) ? make_number (num) : Qnil;
1612 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1613        0, 1, 0,
1614        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1615 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1616 If omitted or nil, the selected frame's display is used.  */)
1617      (display)
1618      Lisp_Object display;
1620   check_ns ();
1621   return make_number ((int)
1622                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1626 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1627        0, 1, 0,
1628        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1629 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1630 If omitted or nil, the selected frame's display is used.  */)
1631      (display)
1632      Lisp_Object display;
1634   check_ns ();
1635   return make_number ((int)
1636                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1640 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1641        Sx_display_backing_store, 0, 1, 0,
1642        doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1643 The value may be `buffered', `retained', or `non-retained'.
1644 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1645 If omitted or nil, the selected frame's display is used.  */)
1646      (display)
1647      Lisp_Object display;
1649   check_ns ();
1650   switch ([ns_get_window (display) backingType])
1651     {
1652     case NSBackingStoreBuffered:
1653       return intern ("buffered");
1654     case NSBackingStoreRetained:
1655       return intern ("retained");
1656     case NSBackingStoreNonretained:
1657       return intern ("non-retained");
1658     default:
1659       error ("Strange value for backingType parameter of frame");
1660     }
1661   return Qnil;  /* not reached, shut compiler up */
1665 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1666        Sx_display_visual_class, 0, 1, 0,
1667        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1668 The value is one of the symbols `static-gray', `gray-scale',
1669 `static-color', `pseudo-color', `true-color', or `direct-color'.
1670 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1671 If omitted or nil, the selected frame's display is used.  */)
1672      (display)
1673      Lisp_Object display;
1675   NSWindowDepth depth;
1676   check_ns ();
1677   depth = [ns_get_screen (display) depth];
1679   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1680     return intern ("static-gray");
1681   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1682     return intern ("gray-scale");
1683   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1684     return intern ("pseudo-color");
1685   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1686     return intern ("true-color");
1687   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1688     return intern ("direct-color");
1689   else
1690     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1691     return intern ("direct-color");
1695 DEFUN ("x-display-save-under", Fx_display_save_under,
1696        Sx_display_save_under, 0, 1, 0,
1697        doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1698 The optional argument DISPLAY specifies which display to ask about.
1699 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1700 If omitted or nil, the selected frame's display is used.  */)
1701      (display)
1702      Lisp_Object display;
1704   check_ns ();
1705   switch ([ns_get_window (display) backingType])
1706     {
1707     case NSBackingStoreBuffered:
1708       return Qt;
1710     case NSBackingStoreRetained:
1711     case NSBackingStoreNonretained:
1712       return Qnil;
1714     default:
1715       error ("Strange value for backingType parameter of frame");
1716     }
1717   return Qnil;  /* not reached, shut compiler up */
1721 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1722        1, 3, 0,
1723        doc: /* Open a connection to a Nextstep display server.
1724 DISPLAY is the name of the display to connect to.
1725 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored.  */)
1726      (display, resource_string, must_succeed)
1727      Lisp_Object display, resource_string, must_succeed;
1729   struct ns_display_info *dpyinfo;
1731   CHECK_STRING (display);
1733   nxatoms_of_nsselect ();
1734   dpyinfo = ns_term_init (display);
1735   if (dpyinfo == 0)
1736     {
1737       if (!NILP (must_succeed))
1738         fatal ("OpenStep on %s not responding.\n",
1739                SDATA (display));
1740       else
1741         error ("OpenStep on %s not responding.\n",
1742                SDATA (display));
1743     }
1745   /* Register our external input/output types, used for determining
1746      applicable services and also drag/drop eligibility. */
1747   ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1748   ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1749   ns_drag_types = [[NSArray arrayWithObjects:
1750                             NSStringPboardType,
1751                             NSTabularTextPboardType,
1752                             NSFilenamesPboardType,
1753                             NSURLPboardType,
1754                             NSColorPboardType,
1755                             NSFontPboardType, nil] retain];
1757   return Qnil;
1761 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1762        1, 1, 0,
1763        doc: /* Close the connection to the current Nextstep display server.
1764 The argument DISPLAY is currently ignored.  */)
1765      (display)
1766      Lisp_Object display;
1768   check_ns ();
1769   /*ns_delete_terminal (dpyinfo->terminal); */
1770   [NSApp terminate: NSApp];
1771   return Qnil;
1775 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1776        doc: /* Return the list of display names that Emacs has connections to.  */)
1777      ()
1779   Lisp_Object tail, result;
1781   result = Qnil;
1782   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1783     result = Fcons (XCAR (XCAR (tail)), result);
1785   return result;
1789 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1790        0, 0, 0,
1791        doc: /* Hides all applications other than Emacs.  */)
1792      ()
1794   check_ns ();
1795   [NSApp hideOtherApplications: NSApp];
1796   return Qnil;
1799 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1800        1, 1, 0,
1801        doc: /* If ON is non-nil, the entire Emacs application is hidden.
1802 Otherwise if Emacs is hidden, it is unhidden.
1803 If ON is equal to `activate', Emacs is unhidden and becomes
1804 the active application.  */)
1805      (on)
1806      Lisp_Object on;
1808   check_ns ();
1809   if (EQ (on, intern ("activate")))
1810     {
1811       [NSApp unhide: NSApp];
1812       [NSApp activateIgnoringOtherApps: YES];
1813     }
1814   else if (NILP (on))
1815     [NSApp unhide: NSApp];
1816   else
1817     [NSApp hide: NSApp];
1818   return Qnil;
1822 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1823        0, 0, 0,
1824        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1825      ()
1827   check_ns ();
1828   [NSApp orderFrontStandardAboutPanel: nil];
1829   return Qnil;
1833 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1834        doc: /* Determine font postscript or family name for font NAME.
1835 NAME should be a string containing either the font name or an XLFD
1836 font descriptor.  If string contains `fontset' and not
1837 `fontset-startup', it is left alone. */)
1838      (name)
1839      Lisp_Object name;
1841   char *nm;
1842   CHECK_STRING (name);
1843   nm = SDATA (name);
1845   if (nm[0] != '-')
1846     return name;
1847   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1848     return name;
1850   return build_string (ns_xlfd_to_fontname (SDATA (name)));
1854 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1855        doc: /* Return a list of all available colors.
1856 The optional argument FRAME is currently ignored.  */)
1857      (frame)
1858      Lisp_Object frame;
1860   Lisp_Object list = Qnil;
1861   NSEnumerator *colorlists;
1862   NSColorList *clist;
1864   if (!NILP (frame))
1865     {
1866       CHECK_FRAME (frame);
1867       if (! FRAME_NS_P (XFRAME (frame)))
1868         error ("non-Nextstep frame used in `ns-list-colors'");
1869     }
1871   BLOCK_INPUT;
1873   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1874   while (clist = [colorlists nextObject])
1875     {
1876       if ([[clist name] length] < 7 ||
1877           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1878         {
1879           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1880           NSString *cname;
1881           while (cname = [cnames nextObject])
1882             list = Fcons (build_string ([cname UTF8String]), list);
1883 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1884                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1885                                              UTF8String]), list); */
1886         }
1887     }
1889   UNBLOCK_INPUT;
1891   return list;
1895 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1896        doc: /* List available Nextstep services by querying NSApp.  */)
1897      ()
1899   Lisp_Object ret = Qnil;
1900   NSMenu *svcs;
1901   id delegate;
1903   check_ns ();
1904   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1905   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
1906   [NSApp registerServicesMenuSendTypes: ns_send_types
1907                            returnTypes: ns_return_types];
1909 /* On Tiger, services menu updating was made lazier (waits for user to
1910    actually click on the menu), so we have to force things along: */
1911 #ifdef NS_IMPL_COCOA
1912   if (NSAppKitVersionNumber >= 744.0)
1913     {
1914       delegate = [svcs delegate];
1915       if (delegate != nil)
1916         {
1917           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1918               [delegate menuNeedsUpdate: svcs];
1919           if ([delegate respondsToSelector:
1920                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1921             {
1922               int i, len = [delegate numberOfItemsInMenu: svcs];
1923               for (i =0; i<len; i++)
1924                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1925               for (i =0; i<len; i++)
1926                   if (![delegate menu: svcs
1927                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1928                               atIndex: i shouldCancel: NO])
1929                     break;
1930             }
1931         }
1932     }
1933 #endif
1935   [svcs setAutoenablesItems: NO];
1936 #ifdef NS_IMPL_COCOA
1937   [svcs update]; /* on OS X, converts from '/' structure */
1938 #endif
1940   ret = interpret_services_menu (svcs, Qnil, ret);
1941   return ret;
1945 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1946        2, 2, 0,
1947        doc: /* Perform Nextstep SERVICE on SEND.
1948 SEND should be either a string or nil.
1949 The return value is the result of the service, as string, or nil if
1950 there was no result.  */)
1951      (service, send)
1952      Lisp_Object service, send;
1954   id pb;
1955   NSString *svcName;
1956   char *utfStr;
1957   int len;
1959   CHECK_STRING (service);
1960   check_ns ();
1962   utfStr = SDATA (service);
1963   svcName = [NSString stringWithUTF8String: utfStr];
1965   pb =[NSPasteboard pasteboardWithUniqueName];
1966   ns_string_to_pasteboard (pb, send);
1968   if (NSPerformService (svcName, pb) == NO)
1969     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
1971   if ([[pb types] count] == 0)
1972     return build_string ("");
1973   return ns_string_from_pasteboard (pb);
1977 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
1978        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
1979        doc: /* Return an NFC string that matches the UTF-8 NFD string STR.  */)
1980     (str)
1981     Lisp_Object str;
1983 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
1984          remove this. */
1985   NSString *utfStr;
1987   CHECK_STRING (str);
1988   utfStr = [NSString stringWithUTF8String: SDATA (str)];
1989   if (![utfStr respondsToSelector:
1990                  @selector (precomposedStringWithCanonicalMapping)])
1991     {
1992       message1
1993         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
1994       return Qnil;
1995     }
1996   else
1997     utfStr = [utfStr precomposedStringWithCanonicalMapping];
1998   return build_string ([utfStr UTF8String]);
2002 #ifdef NS_IMPL_COCOA
2004 /* Compile and execute the AppleScript SCRIPT and return the error
2005    status as function value.  A zero is returned if compilation and
2006    execution is successful, in which case *RESULT is set to a Lisp
2007    string or a number containing the resulting script value.  Otherwise,
2008    1 is returned. */
2009 static int
2010 ns_do_applescript (script, result)
2011      Lisp_Object script, *result;
2013   NSAppleEventDescriptor *desc;
2014   NSDictionary* errorDict;
2015   NSAppleEventDescriptor* returnDescriptor = NULL;
2017   NSAppleScript* scriptObject =
2018     [[NSAppleScript alloc] initWithSource:
2019                              [NSString stringWithUTF8String: SDATA (script)]];
2021   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2022   [scriptObject release];
2024   *result = Qnil;
2026   if (returnDescriptor != NULL)
2027     {
2028       // successful execution
2029       if (kAENullEvent != [returnDescriptor descriptorType])
2030         {
2031           *result = Qt;
2032           // script returned an AppleScript result
2033           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2034 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2035               (typeUTF16ExternalRepresentation
2036                == [returnDescriptor descriptorType]) ||
2037 #endif
2038               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2039               (typeCString == [returnDescriptor descriptorType]))
2040             {
2041               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2042               if (desc)
2043                 *result = build_string([[desc stringValue] UTF8String]);
2044             }
2045           else
2046             {
2047               /* use typeUTF16ExternalRepresentation? */
2048               // coerce the result to the appropriate ObjC type
2049               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2050               if (desc)
2051                 *result = make_number([desc int32Value]);
2052             }
2053         }
2054     }
2055   else
2056     {
2057       // no script result, return error
2058       return 1;
2059     }
2060   return 0;
2063 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2064        doc: /* Execute AppleScript SCRIPT and return the result.
2065 If compilation and execution are successful, the resulting script value
2066 is returned as a string, a number or, in the case of other constructs, t.
2067 In case the execution fails, an error is signaled. */)
2068     (script)
2069     Lisp_Object script;
2071   Lisp_Object result;
2072   long status;
2074   CHECK_STRING (script);
2075   check_ns ();
2077   BLOCK_INPUT;
2078   status = ns_do_applescript (script, &result);
2079   UNBLOCK_INPUT;
2080   if (status == 0)
2081     return result;
2082   else if (!STRINGP (result))
2083     error ("AppleScript error %d", status);
2084   else
2085     error ("%s", SDATA (result));
2087 #endif
2091 /* ==========================================================================
2093     Miscellaneous functions not called through hooks
2095    ========================================================================== */
2098 /* called from image.c */
2099 FRAME_PTR
2100 check_x_frame (Lisp_Object frame)
2102   return check_ns_frame (frame);
2106 /* called from frame.c */
2107 struct ns_display_info *
2108 check_x_display_info (Lisp_Object frame)
2110   return check_ns_display_info (frame);
2114 void
2115 x_set_scroll_bar_default_width (f)
2116      struct frame *f;
2118   int wid = FRAME_COLUMN_WIDTH (f);
2119   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2120   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2121                                       wid - 1) / wid;
2125 /* terms impl this instead of x-get-resource directly */
2126 const char *
2127 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2129   /* remove appname prefix; TODO: allow for !="Emacs" */
2130   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2131   const char *res;
2132   check_ns ();
2134   if (inhibit_x_resources)
2135     /* --quick was passed, so this is a no-op.  */
2136     return NULL;
2138   res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2139             [NSString stringWithUTF8String: toCheck]] UTF8String];
2140   return !res ? NULL :
2141       (!strncasecmp (res, "YES", 3) ? "true" :
2142           (!strncasecmp (res, "NO", 2) ? "false" : res));
2146 Lisp_Object
2147 x_get_focus_frame (struct frame *frame)
2149   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2150   Lisp_Object nsfocus;
2152   if (!dpyinfo->x_focus_frame)
2153     return Qnil;
2155   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2156   return nsfocus;
2161 x_pixel_width (struct frame *f)
2163   return FRAME_PIXEL_WIDTH (f);
2168 x_pixel_height (struct frame *f)
2170   return FRAME_PIXEL_HEIGHT (f);
2175 x_char_width (struct frame *f)
2177   return FRAME_COLUMN_WIDTH (f);
2182 x_char_height (struct frame *f)
2184   return FRAME_LINE_HEIGHT (f);
2189 x_screen_planes (struct frame *f)
2191   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2195 void
2196 x_sync (Lisp_Object frame)
2198   /* XXX Not implemented XXX */
2199   return;
2204 /* ==========================================================================
2206     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2208    ========================================================================== */
2211 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2212        doc: /* Return t if the current Nextstep display supports the color COLOR.
2213 The optional argument FRAME is currently ignored.  */)
2214      (color, frame)
2215      Lisp_Object color, frame;
2217   NSColor * col;
2218   check_ns ();
2219   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2223 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2224        doc: /* Internal function called by `color-values', which see.  */)
2225      (color, frame)
2226      Lisp_Object color, frame;
2228   NSColor * col;
2229   CGFloat red, green, blue, alpha;
2231   check_ns ();
2232   CHECK_STRING (color);
2234   if (ns_lisp_to_color (color, &col))
2235     return Qnil;
2237   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2238         getRed: &red green: &green blue: &blue alpha: &alpha];
2239   return list3 (make_number (lrint (red*65280)),
2240                 make_number (lrint (green*65280)),
2241                 make_number (lrint (blue*65280)));
2245 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2246        doc: /* Return t if the Nextstep display supports color.
2247 The optional argument DISPLAY specifies which display to ask about.
2248 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2249 If omitted or nil, that stands for the selected frame's display.  */)
2250      (display)
2251      Lisp_Object display;
2253   NSWindowDepth depth;
2254   NSString *colorSpace;
2255   check_ns ();
2256   depth = [ns_get_screen (display) depth];
2257   colorSpace = NSColorSpaceFromDepth (depth);
2259   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2260          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2261       ? Qnil : Qt;
2265 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2266        Sx_display_grayscale_p, 0, 1, 0,
2267        doc: /* Return t if the Nextstep display supports shades of gray.
2268 Note that color displays do support shades of gray.
2269 The optional argument DISPLAY specifies which display to ask about.
2270 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2271 If omitted or nil, that stands for the selected frame's display. */)
2272      (display)
2273      Lisp_Object display;
2275   NSWindowDepth depth;
2276   check_ns ();
2277   depth = [ns_get_screen (display) depth];
2279   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2283 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2284        0, 1, 0,
2285        doc: /* Return the width in pixels of the Nextstep display DISPLAY.
2286 The optional argument DISPLAY specifies which display to ask about.
2287 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2288 If omitted or nil, that stands for the selected frame's display.  */)
2289      (display)
2290      Lisp_Object display;
2292   check_ns ();
2293   return make_number ((int) [ns_get_screen (display) frame].size.width);
2297 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2298        Sx_display_pixel_height, 0, 1, 0,
2299        doc: /* Return the height in pixels of the Nextstep display DISPLAY.
2300 The optional argument DISPLAY specifies which display to ask about.
2301 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2302 If omitted or nil, that stands for the selected frame's display.  */)
2303      (display)
2304      Lisp_Object display;
2306   check_ns ();
2307   return make_number ((int) [ns_get_screen (display) frame].size.height);
2311 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2312        Sns_display_usable_bounds, 0, 1, 0,
2313        doc: /* Return the bounds of the usable part of the screen.
2314 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2315 are the boundaries of the usable part of the screen, excluding areas
2316 reserved for the Mac menu, dock, and so forth.
2318 The screen queried corresponds to DISPLAY, which should be either a
2319 frame, a display name (a string), or terminal ID.  If omitted or nil,
2320 that stands for the selected frame's display. */)
2321      (display)
2322      Lisp_Object display;
2324   int top;
2325   NSScreen *screen;
2326   NSRect vScreen;
2328   check_ns ();
2329   screen = ns_get_screen (display);
2330   if (!screen)
2331     return Qnil;
2333   vScreen = [screen visibleFrame];
2335   /* NS coordinate system is upside-down.
2336      Transform to screen-specific coordinates. */
2337   return list4 (make_number ((int) vScreen.origin.x),
2338                 make_number ((int) [screen frame].size.height
2339                              - vScreen.size.height - vScreen.origin.y),
2340                 make_number ((int) vScreen.size.width),
2341                 make_number ((int) vScreen.size.height));
2345 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2346        0, 1, 0,
2347        doc: /* Return the number of bitplanes of the Nextstep display DISPLAY.
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      (display)
2352      Lisp_Object display;
2354   check_ns ();
2355   return make_number
2356     (NSBitsPerPixelFromDepth ([ns_get_screen (display) depth]));
2360 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2361        Sx_display_color_cells, 0, 1, 0,
2362        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2363 The optional argument DISPLAY specifies which display to ask about.
2364 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2365 If omitted or nil, that stands for the selected frame's display.  */)
2366      (display)
2367      Lisp_Object display;
2369   check_ns ();
2370   struct ns_display_info *dpyinfo = check_ns_display_info (display);
2372   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2373   return make_number (1 << min (dpyinfo->n_planes, 24));
2377 /* Unused dummy def needed for compatibility. */
2378 Lisp_Object tip_frame;
2380 /* TODO: move to xdisp or similar */
2381 static void
2382 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2383      struct frame *f;
2384      Lisp_Object parms, dx, dy;
2385      int width, height;
2386      int *root_x, *root_y;
2388   Lisp_Object left, top;
2389   EmacsView *view = FRAME_NS_VIEW (f);
2390   NSPoint pt;
2392   /* Start with user-specified or mouse position.  */
2393   left = Fcdr (Fassq (Qleft, parms));
2394   if (INTEGERP (left))
2395     pt.x = XINT (left);
2396   else
2397     pt.x = last_mouse_motion_position.x;
2398   top = Fcdr (Fassq (Qtop, parms));
2399   if (INTEGERP (top))
2400     pt.y = XINT (top);
2401   else
2402     pt.y = last_mouse_motion_position.y;
2404   /* Convert to screen coordinates */
2405   pt = [view convertPoint: pt toView: nil];
2406   pt = [[view window] convertBaseToScreen: pt];
2408   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2409   if (pt.x + XINT (dx) <= 0)
2410     *root_x = 0; /* Can happen for negative dx */
2411   else if (pt.x + XINT (dx) + width
2412            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2413     /* It fits to the right of the pointer.  */
2414     *root_x = pt.x + XINT (dx);
2415   else if (width + XINT (dx) <= pt.x)
2416     /* It fits to the left of the pointer.  */
2417     *root_x = pt.x - width - XINT (dx);
2418   else
2419     /* Put it left justified on the screen -- it ought to fit that way.  */
2420     *root_x = 0;
2422   if (pt.y - XINT (dy) - height >= 0)
2423     /* It fits below the pointer.  */
2424     *root_y = pt.y - height - XINT (dy);
2425   else if (pt.y + XINT (dy) + height
2426            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2427     /* It fits above the pointer */
2428       *root_y = pt.y + XINT (dy);
2429   else
2430     /* Put it on the top.  */
2431     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2435 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2436        doc: /* Show STRING in a \"tooltip\" window on frame FRAME.
2437 A tooltip window is a small window displaying a string.
2439 FRAME nil or omitted means use the selected frame.
2441 PARMS is an optional list of frame parameters which can be used to
2442 change the tooltip's appearance.
2444 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2445 means use the default timeout of 5 seconds.
2447 If the list of frame parameters PARMS contains a `left' parameter,
2448 the tooltip is displayed at that x-position.  Otherwise it is
2449 displayed at the mouse position, with offset DX added (default is 5 if
2450 DX isn't specified).  Likewise for the y-position; if a `top' frame
2451 parameter is specified, it determines the y-position of the tooltip
2452 window, otherwise it is displayed at the mouse position, with offset
2453 DY added (default is -10).
2455 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2456 Text larger than the specified size is clipped.  */)
2457      (string, frame, parms, timeout, dx, dy)
2458      Lisp_Object string, frame, parms, timeout, dx, dy;
2460   int root_x, root_y;
2461   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2462   int count = SPECPDL_INDEX ();
2463   struct frame *f;
2464   char *str;
2465   NSSize size;
2467   specbind (Qinhibit_redisplay, Qt);
2469   GCPRO4 (string, parms, frame, timeout);
2471   CHECK_STRING (string);
2472   str = SDATA (string);
2473   f = check_x_frame (frame);
2474   if (NILP (timeout))
2475     timeout = make_number (5);
2476   else
2477     CHECK_NATNUM (timeout);
2479   if (NILP (dx))
2480     dx = make_number (5);
2481   else
2482     CHECK_NUMBER (dx);
2484   if (NILP (dy))
2485     dy = make_number (-10);
2486   else
2487     CHECK_NUMBER (dy);
2489   BLOCK_INPUT;
2490   if (ns_tooltip == nil)
2491     ns_tooltip = [[EmacsTooltip alloc] init];
2492   else
2493     Fx_hide_tip ();
2495   [ns_tooltip setText: str];
2496   size = [ns_tooltip frame].size;
2498   /* Move the tooltip window where the mouse pointer is.  Resize and
2499      show it.  */
2500   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2501                   &root_x, &root_y);
2503   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2504   UNBLOCK_INPUT;
2506   UNGCPRO;
2507   return unbind_to (count, Qnil);
2511 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2512        doc: /* Hide the current tooltip window, if there is any.
2513 Value is t if tooltip was open, nil otherwise.  */)
2514      ()
2516   if (ns_tooltip == nil || ![ns_tooltip isActive])
2517     return Qnil;
2518   [ns_tooltip hide];
2519   return Qt;
2523 /* ==========================================================================
2525     Class implementations
2527    ========================================================================== */
2530 @implementation EmacsSavePanel
2531 #ifdef NS_IMPL_COCOA
2532 /* --------------------------------------------------------------------------
2533    These are overridden to intercept on OS X: ending panel restarts NSApp
2534    event loop if it is stopped.  Not sure if this is correct behavior,
2535    perhaps should check if running and if so send an appdefined.
2536    -------------------------------------------------------------------------- */
2537 - (void) ok: (id)sender
2539   [super ok: sender];
2540   panelOK = 1;
2541   [NSApp stop: self];
2543 - (void) cancel: (id)sender
2545   [super cancel: sender];
2546   [NSApp stop: self];
2548 #endif
2549 @end
2552 @implementation EmacsOpenPanel
2553 #ifdef NS_IMPL_COCOA
2554 /* --------------------------------------------------------------------------
2555    These are overridden to intercept on OS X: ending panel restarts NSApp
2556    event loop if it is stopped.  Not sure if this is correct behavior,
2557    perhaps should check if running and if so send an appdefined.
2558    -------------------------------------------------------------------------- */
2559 - (void) ok: (id)sender
2561   [super ok: sender];
2562   panelOK = 1;
2563   [NSApp stop: self];
2565 - (void) cancel: (id)sender
2567   [super cancel: sender];
2568   [NSApp stop: self];
2570 #endif
2571 @end
2574 @implementation EmacsFileDelegate
2575 /* --------------------------------------------------------------------------
2576    Delegate methods for Open/Save panels
2577    -------------------------------------------------------------------------- */
2578 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2580   return YES;
2582 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2584   return YES;
2586 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2587           confirmed: (BOOL)okFlag
2589   return filename;
2591 @end
2593 #endif
2596 /* ==========================================================================
2598     Lisp interface declaration
2600    ========================================================================== */
2603 void
2604 syms_of_nsfns ()
2606   int i;
2608   Qfontsize = intern ("fontsize");
2609   staticpro (&Qfontsize);
2611   DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2612                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2613 If the title of a frame matches REGEXP, then IMAGE.tiff is
2614 selected as the image of the icon representing the frame when it's
2615 miniaturized.  If an element is t, then Emacs tries to select an icon
2616 based on the filetype of the visited file.
2618 The images have to be installed in a folder called English.lproj in the
2619 Emacs folder.  You have to restart Emacs after installing new icons.
2621 Example: Install an icon Gnus.tiff and execute the following code
2623   (setq ns-icon-type-alist
2624         (append ns-icon-type-alist
2625                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2626                    . \"Gnus\"))))
2628 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2629 be used as the image of the icon representing the frame.  */);
2630   Vns_icon_type_alist = Fcons (Qt, Qnil);
2632   DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2633                doc: /* Toolkit version for NS Windowing.  */);
2634   Vns_version_string = ns_appkit_version_str ();
2636   defsubr (&Sns_read_file_name);
2637   defsubr (&Sns_get_resource);
2638   defsubr (&Sns_set_resource);
2639   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2640   defsubr (&Sx_display_grayscale_p);
2641   defsubr (&Sns_font_name);
2642   defsubr (&Sns_list_colors);
2643 #ifdef NS_IMPL_COCOA
2644   defsubr (&Sns_do_applescript);
2645 #endif
2646   defsubr (&Sxw_color_defined_p);
2647   defsubr (&Sxw_color_values);
2648   defsubr (&Sx_server_max_request_size);
2649   defsubr (&Sx_server_vendor);
2650   defsubr (&Sx_server_version);
2651   defsubr (&Sx_display_pixel_width);
2652   defsubr (&Sx_display_pixel_height);
2653   defsubr (&Sns_display_usable_bounds);
2654   defsubr (&Sx_display_mm_width);
2655   defsubr (&Sx_display_mm_height);
2656   defsubr (&Sx_display_screens);
2657   defsubr (&Sx_display_planes);
2658   defsubr (&Sx_display_color_cells);
2659   defsubr (&Sx_display_visual_class);
2660   defsubr (&Sx_display_backing_store);
2661   defsubr (&Sx_display_save_under);
2662   defsubr (&Sx_create_frame);
2663   defsubr (&Sx_open_connection);
2664   defsubr (&Sx_close_connection);
2665   defsubr (&Sx_display_list);
2667   defsubr (&Sns_hide_others);
2668   defsubr (&Sns_hide_emacs);
2669   defsubr (&Sns_emacs_info_panel);
2670   defsubr (&Sns_list_services);
2671   defsubr (&Sns_perform_service);
2672   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2673   defsubr (&Sx_focus_frame);
2674   defsubr (&Sns_popup_font_panel);
2675   defsubr (&Sns_popup_color_panel);
2677   defsubr (&Sx_show_tip);
2678   defsubr (&Sx_hide_tip);
2680   /* used only in fontset.c */
2681   check_window_system_func = check_ns;
2685 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642