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