(rmail-retry-failure): Use rmail-get-header rather than a magical
[emacs.git] / src / nsfns.m
blob963445b624cd7ccb5253fe19d12ac16442d035a2
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 anythingUnderTheSun)
208   id window =nil;
209   NSScreen *screen = 0;
211   struct terminal *terminal;
212   struct ns_display_info *dpyinfo;
213   struct frame *f = NULL;
214   Lisp_Object frame;
216   if (INTEGERP (anythingUnderTheSun)) {
217     /* we got a terminal */
218     terminal = get_terminal (anythingUnderTheSun, 1);
219     dpyinfo = terminal->display_info.ns;
220     f = dpyinfo->x_focus_frame;
221     if (!f)
222       f = dpyinfo->x_highlight_frame;
224   } else if (FRAMEP (anythingUnderTheSun) &&
225              FRAME_NS_P (XFRAME (anythingUnderTheSun))) {
226     /* we got a frame */
227     f = XFRAME (anythingUnderTheSun);
229   } else if (STRINGP (anythingUnderTheSun)) { /* FIXME/cl for multi-display */
230   }
232   if (!f)
233     f = SELECTED_FRAME ();
234   if (f)
235     {
236       XSETFRAME (frame, f);
237       window = ns_get_window (frame);
238     }
240   if (window)
241     screen = [window screen];
242   if (!screen)
243     screen = [NSScreen mainScreen];
245   return screen;
249 /* Return the X display structure for the display named NAME.
250    Open a new connection if necessary.  */
251 struct ns_display_info *
252 ns_display_info_for_name (name)
253      Lisp_Object name;
255   Lisp_Object names;
256   struct ns_display_info *dpyinfo;
258   CHECK_STRING (name);
260   for (dpyinfo = x_display_list, names = ns_display_name_list;
261        dpyinfo;
262        dpyinfo = dpyinfo->next, names = XCDR (names))
263     {
264       Lisp_Object tem;
265       tem = Fstring_equal (XCAR (XCAR (names)), name);
266       if (!NILP (tem))
267         return dpyinfo;
268     }
270   error ("Emacs for OpenStep does not yet support multi-display.");
272   Fx_open_connection (name, Qnil, Qnil);
273   dpyinfo = x_display_list;
275   if (dpyinfo == 0)
276     error ("OpenStep on %s not responding.\n", SDATA (name));
278   return dpyinfo;
282 static Lisp_Object
283 interpret_services_menu (NSMenu *menu, Lisp_Object prefix, Lisp_Object old)
284 /* --------------------------------------------------------------------------
285    Turn the input menu (an NSMenu) into a lisp list for tracking on lisp side
286    -------------------------------------------------------------------------- */
288   int i, count;
289   NSMenuItem *item;
290   const char *name;
291   Lisp_Object nameStr;
292   unsigned short key;
293   NSString *keys;
294   Lisp_Object res;
296   count = [menu numberOfItems];
297   for (i = 0; i<count; i++)
298     {
299       item = [menu itemAtIndex: i];
300       name = [[item title] UTF8String];
301       if (!name) continue;
303       nameStr = build_string (name);
305       if ([item hasSubmenu])
306         {
307           old = interpret_services_menu ([item submenu],
308                                         Fcons (nameStr, prefix), old);
309         }
310       else
311         {
312           keys = [item keyEquivalent];
313           if (keys && [keys length] )
314             {
315               key = [keys characterAtIndex: 0];
316               res = make_number (key|super_modifier);
317             }
318           else
319             {
320               res = Qundefined;
321             }
322           old = Fcons (Fcons (res,
323                             Freverse (Fcons (nameStr,
324                                            prefix))),
325                     old);
326         }
327     }
328   return old;
333 /* ==========================================================================
335     Frame parameter setters
337    ========================================================================== */
340 static void
341 x_set_foreground_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
343   NSColor *col;
345   if (ns_lisp_to_color (arg, &col))
346     {
347       store_frame_param (f, Qforeground_color, oldval);
348       error ("Unknown color");
349     }
351   [col retain];
352   [f->output_data.ns->foreground_color release];
353   f->output_data.ns->foreground_color = col;
355   if (FRAME_NS_VIEW (f))
356     {
357       update_face_from_frame_parameter (f, Qforeground_color, arg);
358       /*recompute_basic_faces (f); */
359       if (FRAME_VISIBLE_P (f))
360         redraw_frame (f);
361     }
365 static void
366 x_set_background_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
368   struct face *face;
369   NSColor *col;
370   NSView *view = FRAME_NS_VIEW (f);
371   float alpha;
373   if (ns_lisp_to_color (arg, &col))
374     {
375       store_frame_param (f, Qbackground_color, oldval);
376       error ("Unknown color");
377     }
379   /* clear the frame; in some instances the NS-internal GC appears not to
380      update, or it does update and cannot clear old text properly */
381   if (FRAME_VISIBLE_P (f))
382     ns_clear_frame (f);
384   [col retain];
385   [f->output_data.ns->background_color release];
386   f->output_data.ns->background_color = col;
387   if (view != nil)
388     {
389       [[view window] setBackgroundColor: col];
390       alpha = [col alphaComponent];
392       if (alpha != 1.0)
393           [[view window] setOpaque: NO];
394       else
395           [[view window] setOpaque: YES];
397       face = FRAME_DEFAULT_FACE (f);
398       if (face)
399         {
400           col = ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), f);
401           face->background
402              = (EMACS_UINT) [[col colorWithAlphaComponent: alpha] retain];
403           [col release];
405           update_face_from_frame_parameter (f, Qbackground_color, arg);
406         }
408       if (FRAME_VISIBLE_P (f))
409         redraw_frame (f);
410     }
414 static void
415 x_set_cursor_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
417   NSColor *col;
419   if (ns_lisp_to_color (arg, &col))
420     {
421       store_frame_param (f, Qcursor_color, oldval);
422       error ("Unknown color");
423     }
425   [FRAME_CURSOR_COLOR (f) release];
426   FRAME_CURSOR_COLOR (f) = [col retain];
428   if (FRAME_VISIBLE_P (f))
429     {
430       x_update_cursor (f, 0);
431       x_update_cursor (f, 1);
432     }
433   update_face_from_frame_parameter (f, Qcursor_color, arg);
437 static void
438 x_set_icon_name (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
440   NSView *view = FRAME_NS_VIEW (f);
441   NSTRACE (x_set_icon_name);
443   if (ns_in_resize)
444     return;
446   /* see if it's changed */
447   if (STRINGP (arg))
448     {
449       if (STRINGP (oldval) && EQ (Fstring_equal (oldval, arg), Qt))
450         return;
451     }
452   else if (!STRINGP (oldval) && EQ (oldval, Qnil) == EQ (arg, Qnil))
453     return;
455   f->icon_name = arg;
457   if (NILP (arg))
458     {
459       if (!NILP (f->title))
460         arg = f->title;
461       else
462         /* explicit name and no icon-name -> explicit_name */
463         if (f->explicit_name)
464           arg = f->name;
465         else
466           {
467             /* no explicit name and no icon-name ->
468                name has to be rebuild from icon_title_format */
469             windows_or_buffers_changed++;
470             return;
471           }
472     }
474   /* Don't change the name if it's already NAME.  */
475   if ([[view window] miniwindowTitle] &&
476       ([[[view window] miniwindowTitle]
477              isEqualToString: [NSString stringWithUTF8String:
478                                            SDATA (arg)]]))
479     return;
481   [[view window] setMiniwindowTitle:
482         [NSString stringWithUTF8String: SDATA (arg)]];
486 static void
487 ns_set_name_iconic (struct frame *f, Lisp_Object name, int explicit)
489   NSView *view = FRAME_NS_VIEW (f);
490   NSTRACE (ns_set_name_iconic);
492   if (ns_in_resize)
493     return;
495   /* Make sure that requests from lisp code override requests from
496      Emacs redisplay code.  */
497   if (explicit)
498     {
499       /* If we're switching from explicit to implicit, we had better
500          update the mode lines and thereby update the title.  */
501       if (f->explicit_name && NILP (name))
502         update_mode_lines = 1;
504       f->explicit_name = ! NILP (name);
505     }
506   else if (f->explicit_name)
507     name = f->name;
509   /* title overrides explicit name */
510   if (! NILP (f->title))
511     name = f->title;
513   /* icon_name overrides title and explicit name */
514   if (! NILP (f->icon_name))
515     name = f->icon_name;
517   if (NILP (name))
518     name = build_string
519         ([[[NSProcessInfo processInfo] processName] UTF8String]);
520   else
521     CHECK_STRING (name);
523   /* Don't change the name if it's already NAME.  */
524   if ([[view window] miniwindowTitle] &&
525       ([[[view window] miniwindowTitle]
526              isEqualToString: [NSString stringWithUTF8String:
527                                            SDATA (name)]]))
528     return;
530   [[view window] setMiniwindowTitle:
531         [NSString stringWithUTF8String: SDATA (name)]];
535 static void
536 ns_set_name (struct frame *f, Lisp_Object name, int explicit)
538   NSView *view = FRAME_NS_VIEW (f);
539   NSTRACE (ns_set_name);
541   if (ns_in_resize)
542     return;
544   /* Make sure that requests from lisp code override requests from
545      Emacs redisplay code.  */
546   if (explicit)
547     {
548       /* If we're switching from explicit to implicit, we had better
549          update the mode lines and thereby update the title.  */
550       if (f->explicit_name && NILP (name))
551         update_mode_lines = 1;
553       f->explicit_name = ! NILP (name);
554     }
555   else if (f->explicit_name)
556     return;
558   if (NILP (name))
559     name = build_string
560         ([[[NSProcessInfo processInfo] processName] UTF8String]);
562   f->name = name;
564   /* title overrides explicit name */
565   if (! NILP (f->title))
566     name = f->title;
568   CHECK_STRING (name);
570   /* Don't change the name if it's already NAME.  */
571   if ([[[view window] title]
572             isEqualToString: [NSString stringWithUTF8String:
573                                           SDATA (name)]])
574     return;
575   [[view window] setTitle: [NSString stringWithUTF8String:
576                                         SDATA (name)]];
580 /* This function should be called when the user's lisp code has
581    specified a name for the frame; the name will override any set by the
582    redisplay code.  */
583 static void
584 x_explicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
586   NSTRACE (x_explicitly_set_name);
587   ns_set_name_iconic (f, arg, 1);
588   ns_set_name (f, arg, 1);
592 /* This function should be called by Emacs redisplay code to set the
593    name; names set this way will never override names set by the user's
594    lisp code.  */
595 void
596 x_implicitly_set_name (FRAME_PTR f, Lisp_Object arg, Lisp_Object oldval)
598   NSTRACE (x_implicitly_set_name);
599   if (FRAME_ICONIFIED_P (f))
600     ns_set_name_iconic (f, arg, 0);
601   else
602     ns_set_name (f, arg, 0);
606 /* Change the title of frame F to NAME.
607    If NAME is nil, use the frame name as the title.
609    If EXPLICIT is non-zero, that indicates that lisp code is setting the
610    name; if NAME is a string, set F's name to NAME and set
611    F->explicit_name; if NAME is Qnil, then clear F->explicit_name.
613    If EXPLICIT is zero, that indicates that Emacs redisplay code is
614    suggesting a new name, which lisp code should override; if
615    F->explicit_name is set, ignore the new name; otherwise, set it.  */
616 static void
617 x_set_title (struct frame *f, Lisp_Object name, Lisp_Object old_name)
619   NSTRACE (x_set_title);
620   /* Don't change the title if it's already NAME.  */
621   if (EQ (name, f->title))
622     return;
624   update_mode_lines = 1;
626   f->title = name;
630 void
631 ns_set_name_as_filename (struct frame *f)
633   NSView *view = FRAME_NS_VIEW (f);
634   Lisp_Object name;
635   Lisp_Object buf = XWINDOW (f->selected_window)->buffer;
636   const char *title;
637   NSAutoreleasePool *pool;
638   NSTRACE (ns_set_name_as_filename);
640   if (f->explicit_name || ! NILP (f->title) || ns_in_resize)
641     return;
643   BLOCK_INPUT;
644   pool = [[NSAutoreleasePool alloc] init];
645   name =XBUFFER (buf)->filename;
646   if (NILP (name) || FRAME_ICONIFIED_P (f)) name =XBUFFER (buf)->name;
648   if (FRAME_ICONIFIED_P (f) && !NILP (f->icon_name))
649     name = f->icon_name;
651   if (NILP (name))
652     name = build_string
653         ([[[NSProcessInfo processInfo] processName] UTF8String]);
654   else
655     CHECK_STRING (name);
657   title = FRAME_ICONIFIED_P (f) ? [[[view window] miniwindowTitle] UTF8String]
658                                 : [[[view window] title] UTF8String];
660   if (title && (! strcmp (title, SDATA (name))))
661     {
662       [pool release];
663       UNBLOCK_INPUT;
664       return;
665     }
667   if (! FRAME_ICONIFIED_P (f))
668     {
669 #ifdef NS_IMPL_COCOA
670       /* work around a bug observed on 10.3 where
671          setTitleWithRepresentedFilename does not clear out previous state
672          if given filename does not exist */
673       NSString *str = [NSString stringWithUTF8String: SDATA (name)];
674       if (![[NSFileManager defaultManager] fileExistsAtPath: str])
675         {
676           [[view window] setTitleWithRepresentedFilename: @""];
677           [[view window] setTitle: str];
678         }
679       else
680         {
681           [[view window] setTitleWithRepresentedFilename: str];
682         }
683 #else
684       [[view window] setTitleWithRepresentedFilename:
685                          [NSString stringWithUTF8String: SDATA (name)]];
686 #endif
687       f->name = name;
688     }
689   else
690     {
691       [[view window] setMiniwindowTitle:
692             [NSString stringWithUTF8String: SDATA (name)]];
693     }
694   [pool release];
695   UNBLOCK_INPUT;
699 void
700 ns_set_doc_edited (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
702   NSView *view = FRAME_NS_VIEW (f);
703   NSAutoreleasePool *pool;
704   BLOCK_INPUT;
705   pool = [[NSAutoreleasePool alloc] init];
706   [[view window] setDocumentEdited: !NILP (arg)];
707   [pool release];
708   UNBLOCK_INPUT;
712 void
713 x_set_menu_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
715   int nlines;
716   int olines = FRAME_MENU_BAR_LINES (f);
717   if (FRAME_MINIBUF_ONLY_P (f))
718     return;
720   if (INTEGERP (value))
721     nlines = XINT (value);
722   else
723     nlines = 0;
725   FRAME_MENU_BAR_LINES (f) = 0;
726   if (nlines)
727     {
728       FRAME_EXTERNAL_MENU_BAR (f) = 1;
729       /* does for all frames, whereas we just want for one frame
730          [NSMenu setMenuBarVisible: YES]; */
731     }
732   else
733     {
734       if (FRAME_EXTERNAL_MENU_BAR (f) == 1)
735         free_frame_menubar (f);
736       /*      [NSMenu setMenuBarVisible: NO]; */
737       FRAME_EXTERNAL_MENU_BAR (f) = 0;
738     }
742 /* toolbar support */
743 void
744 x_set_tool_bar_lines (struct frame *f, Lisp_Object value, Lisp_Object oldval)
746   int nlines;
747   Lisp_Object root_window;
749   if (FRAME_MINIBUF_ONLY_P (f))
750     return;
752   if (INTEGERP (value) && XINT (value) >= 0)
753     nlines = XFASTINT (value);
754   else
755     nlines = 0;
757   if (nlines)
758     {
759       FRAME_EXTERNAL_TOOL_BAR (f) = 1;
760       update_frame_tool_bar (f);
761     }
762   else
763     {
764       if (FRAME_EXTERNAL_TOOL_BAR (f))
765         {
766           free_frame_tool_bar (f);
767           FRAME_EXTERNAL_TOOL_BAR (f) = 0;
768         }
769     }
771   x_set_window_size (f, 0, f->text_cols, f->text_lines);
775 void
776 ns_implicitly_set_icon_type (struct frame *f)
778   Lisp_Object tem;
779   EmacsView *view = FRAME_NS_VIEW (f);
780   id image =nil;
781   Lisp_Object chain, elt;
782   NSAutoreleasePool *pool;
783   BOOL setMini = YES;
785   NSTRACE (ns_implicitly_set_icon_type);
787   BLOCK_INPUT;
788   pool = [[NSAutoreleasePool alloc] init];
789   if (f->output_data.ns->miniimage
790       && [[NSString stringWithUTF8String: SDATA (f->name)]
791                isEqualToString: [(NSImage *)f->output_data.ns->miniimage name]])
792     {
793       [pool release];
794       UNBLOCK_INPUT;
795       return;
796     }
798   tem = assq_no_quit (Qicon_type, f->param_alist);
799   if (CONSP (tem) && ! NILP (XCDR (tem)))
800     {
801       [pool release];
802       UNBLOCK_INPUT;
803       return;
804     }
806   for (chain = Vns_icon_type_alist;
807        (image = nil) && CONSP (chain);
808        chain = XCDR (chain))
809     {
810       elt = XCAR (chain);
811       /* special case: 't' means go by file type */
812       if (SYMBOLP (elt) && EQ (elt, Qt) && SDATA (f->name)[0] == '/')
813         {
814           NSString *str
815              = [NSString stringWithUTF8String: SDATA (f->name)];
816           if ([[NSFileManager defaultManager] fileExistsAtPath: str])
817             image = [[[NSWorkspace sharedWorkspace] iconForFile: str] retain];
818         }
819       else if (CONSP (elt) &&
820                STRINGP (XCAR (elt)) &&
821                STRINGP (XCDR (elt)) &&
822                fast_string_match (XCAR (elt), f->name) >= 0)
823         {
824           image = [EmacsImage allocInitFromFile: XCDR (elt)];
825           if (image == nil)
826             image = [[NSImage imageNamed:
827                                [NSString stringWithUTF8String:
828                                             SDATA (XCDR (elt))]] retain];
829         }
830     }
832   if (image == nil)
833     {
834       image = [[[NSWorkspace sharedWorkspace] iconForFileType: @"text"] retain];
835       setMini = NO;
836     }
838   [f->output_data.ns->miniimage release];
839   f->output_data.ns->miniimage = image;
840   [view setMiniwindowImage: setMini];
841   [pool release];
842   UNBLOCK_INPUT;
846 static void
847 x_set_icon_type (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
849   EmacsView *view = FRAME_NS_VIEW (f);
850   id image = nil;
851   BOOL setMini = YES;
853   NSTRACE (x_set_icon_type);
855   if (!NILP (arg) && SYMBOLP (arg))
856     {
857       arg =build_string (SDATA (SYMBOL_NAME (arg)));
858       store_frame_param (f, Qicon_type, arg);
859     }
861   /* do it the implicit way */
862   if (NILP (arg))
863     {
864       ns_implicitly_set_icon_type (f);
865       return;
866     }
868   CHECK_STRING (arg);
870   image = [EmacsImage allocInitFromFile: arg];
871   if (image == nil)
872     image =[NSImage imageNamed: [NSString stringWithUTF8String:
873                                             SDATA (arg)]];
875   if (image == nil)
876     {
877       image = [NSImage imageNamed: @"text"];
878       setMini = NO;
879     }
881   f->output_data.ns->miniimage = image;
882   [view setMiniwindowImage: setMini];
886 /* Xism; we stub out (we do implement this in ns-win.el) */
888 XParseGeometry (char *string, int *x, int *y,
889                 unsigned int *width, unsigned int *height)
891   message1 ("Warning: XParseGeometry not supported under NS.\n");
892   return 0;
896 /* TODO: move to nsterm? */
898 ns_lisp_to_cursor_type (Lisp_Object arg)
900   char *str;
901   if (XTYPE (arg) == Lisp_String)
902     str = SDATA (arg);
903   else if (XTYPE (arg) == Lisp_Symbol)
904     str = SDATA (SYMBOL_NAME (arg));
905   else return -1;
906   if (!strcmp (str, "box"))     return FILLED_BOX_CURSOR;
907   if (!strcmp (str, "hollow"))  return HOLLOW_BOX_CURSOR;
908   if (!strcmp (str, "hbar"))    return HBAR_CURSOR;
909   if (!strcmp (str, "bar"))     return BAR_CURSOR;
910   if (!strcmp (str, "no"))      return NO_CURSOR;
911   return -1;
915 Lisp_Object
916 ns_cursor_type_to_lisp (int arg)
918   switch (arg)
919     {
920     case FILLED_BOX_CURSOR: return Qbox;
921     case HOLLOW_BOX_CURSOR: return intern ("hollow");
922     case HBAR_CURSOR:       return intern ("hbar");
923     case BAR_CURSOR:        return intern ("bar");
924     case NO_CURSOR:
925     default:                return intern ("no");
926     }
929 /* This is the same as the xfns.c definition.  */
930 void
931 x_set_cursor_type (f, arg, oldval)
932      FRAME_PTR f;
933      Lisp_Object arg, oldval;
935   set_frame_cursor_types (f, arg);
937   /* Make sure the cursor gets redrawn.  */
938   cursor_type_changed = 1;
942 /* called to set mouse pointer color, but all other terms use it to
943    initialize pointer types (and don't set the color ;) */
944 static void
945 x_set_mouse_color (struct frame *f, Lisp_Object arg, Lisp_Object oldval)
947   /* don't think we can do this on Nextstep */
951 #define Str(x) #x
952 #define Xstr(x) Str(x)
954 static Lisp_Object
955 ns_appkit_version_str ()
957   char tmp[80];
959 #ifdef NS_IMPL_GNUSTEP
960   sprintf(tmp, "gnustep-gui-%s", Xstr(GNUSTEP_GUI_VERSION));
961 #elif defined(NS_IMPL_COCOA)
962   sprintf(tmp, "apple-appkit-%.2f", NSAppKitVersionNumber);
963 #else
964   tmp = "ns-unknown";
965 #endif
966   return build_string (tmp);
970 /* This is for use by x-server-version and collapses all version info we
971    have into a single int.  For a better picture of the implementation
972    running, use ns_appkit_version_str.*/
973 static int
974 ns_appkit_version_int ()
976 #ifdef NS_IMPL_GNUSTEP
977   return GNUSTEP_GUI_MAJOR_VERSION * 100 + GNUSTEP_GNU_MINOR_VERSION;
978 #elif defined(NS_IMPL_COCOA)
979   return (int)NSAppKitVersionNumber;
980 #endif
981   return 0;
985 static void
986 x_icon (struct frame *f, Lisp_Object parms)
987 /* --------------------------------------------------------------------------
988    Strangely-named function to set icon position parameters in frame.
989    This is irrelevant under OS X, but might be needed under GNUstep,
990    depending on the window manager used.  Note, this is not a standard
991    frame parameter-setter; it is called directly from x-create-frame.
992    -------------------------------------------------------------------------- */
994   Lisp_Object icon_x, icon_y;
995   struct ns_display_info *dpyinfo = check_ns_display_info (Qnil);
997   f->output_data.ns->icon_top = Qnil;
998   f->output_data.ns->icon_left = Qnil;
1000   /* Set the position of the icon.  */
1001   icon_x = x_get_arg (dpyinfo, parms, Qicon_left, 0, 0, RES_TYPE_NUMBER);
1002   icon_y = x_get_arg (dpyinfo, parms, Qicon_top, 0, 0,  RES_TYPE_NUMBER);
1003   if (!EQ (icon_x, Qunbound) && !EQ (icon_y, Qunbound))
1004     {
1005       CHECK_NUMBER (icon_x);
1006       CHECK_NUMBER (icon_y);
1007       f->output_data.ns->icon_top = icon_y;
1008       f->output_data.ns->icon_left = icon_x;
1009     }
1010   else if (!EQ (icon_x, Qunbound) || !EQ (icon_y, Qunbound))
1011     error ("Both left and top icon corners of icon must be specified");
1015 /* Note: see frame.c for template, also where generic functions are impl */
1016 frame_parm_handler ns_frame_parm_handlers[] =
1018   x_set_autoraise, /* generic OK */
1019   x_set_autolower, /* generic OK */
1020   x_set_background_color,
1021   0, /* x_set_border_color,  may be impossible under Nextstep */
1022   0, /* x_set_border_width,  may be impossible under Nextstep */
1023   x_set_cursor_color,
1024   x_set_cursor_type,
1025   x_set_font, /* generic OK */
1026   x_set_foreground_color,
1027   x_set_icon_name,
1028   x_set_icon_type,
1029   x_set_internal_border_width, /* generic OK */
1030   x_set_menu_bar_lines,
1031   x_set_mouse_color,
1032   x_explicitly_set_name,
1033   x_set_scroll_bar_width, /* generic OK */
1034   x_set_title,
1035   x_set_unsplittable, /* generic OK */
1036   x_set_vertical_scroll_bars, /* generic OK */
1037   x_set_visibility, /* generic OK */
1038   x_set_tool_bar_lines,
1039   0, /* x_set_scroll_bar_foreground, will ignore (not possible on NS) */
1040   0, /* x_set_scroll_bar_background,  will ignore (not possible on NS) */
1041   x_set_screen_gamma, /* generic OK */
1042   x_set_line_spacing, /* generic OK, sets f->extra_line_spacing to int */
1043   x_set_fringe_width, /* generic OK */
1044   x_set_fringe_width, /* generic OK */
1045   0, /* x_set_wait_for_wm, will ignore */
1046   0,  /* x_set_fullscreen will ignore */
1047   x_set_font_backend, /* generic OK */
1048   x_set_alpha
1053 /* ==========================================================================
1055     Lisp definitions
1057    ========================================================================== */
1059 DEFUN ("x-create-frame", Fx_create_frame, Sx_create_frame,
1060        1, 1, 0,
1061        doc: /* Make a new Nextstep window, called a \"frame\" in Emacs terms.
1062 Return an Emacs frame object.
1063 PARMS is an alist of frame parameters.
1064 If the parameters specify that the frame should not have a minibuffer,
1065 and do not specify a specific minibuffer window to use,
1066 then `default-minibuffer-frame' must be a frame whose minibuffer can
1067 be shared by the new frame.  */)
1068      (parms)
1069      Lisp_Object parms;
1071   static int desc_ctr = 1;
1072   struct frame *f;
1073   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1074   Lisp_Object frame, tem;
1075   Lisp_Object name;
1076   int minibuffer_only = 0;
1077   int count = specpdl_ptr - specpdl;
1078   Lisp_Object display;
1079   struct ns_display_info *dpyinfo = NULL;
1080   Lisp_Object parent;
1081   struct kboard *kb;
1082   Lisp_Object tfont, tfontsize;
1083   int window_prompting = 0;
1084   int width, height;
1086   check_ns ();
1088   /* Seems a little strange, but other terms do it. Perhaps the code below
1089      is modifying something? */
1090   parms = Fcopy_alist (parms);
1092   display = x_get_arg (dpyinfo, parms, Qterminal, 0, 0, RES_TYPE_STRING);
1093   if (EQ (display, Qunbound))
1094     display = Qnil;
1095   dpyinfo = check_ns_display_info (display);
1097   if (!dpyinfo->terminal->name)
1098     error ("Terminal is not live, can't create new frames on it");
1100   kb = dpyinfo->terminal->kboard;
1102   name = x_get_arg (dpyinfo, parms, Qname, 0, 0, RES_TYPE_STRING);
1103   if (!STRINGP (name)
1104       && ! EQ (name, Qunbound)
1105       && ! NILP (name))
1106     error ("Invalid frame name--not a string or nil");
1108   if (STRINGP (name))
1109     Vx_resource_name = name;
1110   else
1111     Vx_resource_name = Vinvocation_name;
1113   parent = x_get_arg (dpyinfo, parms, Qparent_id, 0, 0, RES_TYPE_NUMBER);
1114   if (EQ (parent, Qunbound))
1115     parent = Qnil;
1116   if (! NILP (parent))
1117     CHECK_NUMBER (parent);
1119   frame = Qnil;
1120   GCPRO4 (parms, parent, name, frame);
1122   tem = x_get_arg (dpyinfo, parms, Qminibuffer, "minibuffer", "Minibuffer",
1123                   RES_TYPE_SYMBOL);
1124   if (EQ (tem, Qnone) || NILP (tem))
1125     {
1126       f = make_frame_without_minibuffer (Qnil, kb, display);
1127     }
1128   else if (EQ (tem, Qonly))
1129     {
1130       f = make_minibuffer_frame ();
1131       minibuffer_only = 1;
1132     }
1133   else if (WINDOWP (tem))
1134     {
1135       f = make_frame_without_minibuffer (tem, kb, display);
1136     }
1137   else
1138     {
1139       f = make_frame (1);
1140     }
1142   /* Set the name; the functions to which we pass f expect the name to
1143      be set.  */
1144   if (EQ (name, Qunbound) || NILP (name) || (XTYPE (name) != Lisp_String))
1145     {
1146       f->name
1147          = build_string ([[[NSProcessInfo processInfo] processName] UTF8String]);
1148       f->explicit_name =0;
1149     }
1150   else
1151     {
1152       f->name = name;
1153       f->explicit_name = 1;
1154       specbind (Qx_resource_name, name);
1155     }
1157   XSETFRAME (frame, f);
1158   FRAME_CAN_HAVE_SCROLL_BARS (f) = 1;
1160   f->terminal = dpyinfo->terminal;
1161   f->terminal->reference_count++;
1163   f->output_method = output_ns;
1164   f->output_data.ns = (struct ns_output *)xmalloc (sizeof *(f->output_data.ns));
1165   bzero (f->output_data.ns, sizeof (*(f->output_data.ns)));
1167   FRAME_FONTSET (f) = -1;
1169   /* record_unwind_protect (unwind_create_frame, frame); safety; maybe later? */
1171   f->icon_name = x_get_arg (dpyinfo, parms, Qicon_name, "iconName", "Title",
1172                             RES_TYPE_STRING);
1173   if (! STRINGP (f->icon_name))
1174     f->icon_name = Qnil;
1176   FRAME_NS_DISPLAY_INFO (f) = dpyinfo;
1178   f->output_data.ns->window_desc = desc_ctr++;
1179   if (!NILP (parent))
1180     {
1181       f->output_data.ns->parent_desc = (Window) XFASTINT (parent);
1182       f->output_data.ns->explicit_parent = 1;
1183     }
1184   else
1185     {
1186       f->output_data.ns->parent_desc = FRAME_NS_DISPLAY_INFO (f)->root_window;
1187       f->output_data.ns->explicit_parent = 0;
1188     }
1190   f->resx = dpyinfo->resx;
1191   f->resy = dpyinfo->resy;
1193   BLOCK_INPUT;
1194   register_font_driver (&nsfont_driver, f);
1195   x_default_parameter (f, parms, Qfont_backend, Qnil,
1196                         "fontBackend", "FontBackend", RES_TYPE_STRING);
1198   {
1199     /* use for default font name */
1200     id font = [NSFont userFixedPitchFontOfSize: -1.0]; /* default */
1201     tfontsize = x_default_parameter (f, parms, Qfontsize,
1202                                     make_number (0 /*(int)[font pointSize]*/),
1203                                     "fontSize", "FontSize", RES_TYPE_NUMBER);
1204     tfont = x_default_parameter (f, parms, Qfont,
1205                                  build_string ([[font fontName] UTF8String]),
1206                                  "font", "Font", RES_TYPE_STRING);
1207   }
1208   UNBLOCK_INPUT;
1210   x_default_parameter (f, parms, Qborder_width, make_number (0),
1211                        "borderwidth", "BorderWidth", RES_TYPE_NUMBER);
1212   x_default_parameter (f, parms, Qinternal_border_width, make_number (2),
1213                       "internalBorderWidth", "InternalBorderWidth",
1214                       RES_TYPE_NUMBER);
1216   /* default scrollbars on right on Mac */
1217   {
1218       Lisp_Object spos
1219 #ifdef NS_IMPL_GNUSTEP
1220           = Qt;
1221 #else
1222           = Qright;
1223 #endif
1224       x_default_parameter (f, parms, Qvertical_scroll_bars, spos,
1225                            "verticalScrollBars", "VerticalScrollBars",
1226                            RES_TYPE_SYMBOL);
1227   }
1228   x_default_parameter (f, parms, Qforeground_color, build_string ("Black"),
1229                       "foreground", "Foreground", RES_TYPE_STRING);
1230   x_default_parameter (f, parms, Qbackground_color, build_string ("White"),
1231                       "background", "Background", RES_TYPE_STRING);
1232   x_default_parameter (f, parms, Qcursor_color, build_string ("grey"),
1233                       "cursorColor", "CursorColor", RES_TYPE_STRING);
1234   /* FIXME: not suppported yet in Nextstep */
1235   x_default_parameter (f, parms, Qline_spacing, Qnil,
1236                        "lineSpacing", "LineSpacing", RES_TYPE_NUMBER);
1237   x_default_parameter (f, parms, Qleft_fringe, Qnil,
1238                        "leftFringe", "LeftFringe", RES_TYPE_NUMBER);
1239   x_default_parameter (f, parms, Qright_fringe, Qnil,
1240                        "rightFringe", "RightFringe", RES_TYPE_NUMBER);
1241   /* end PENDING */
1243   init_frame_faces (f);
1245   x_default_parameter (f, parms, Qmenu_bar_lines, make_number (0), "menuBar",
1246                       "menuBar", RES_TYPE_NUMBER);
1247   x_default_parameter (f, parms, Qtool_bar_lines, make_number (0), "toolBar",
1248                       "toolBar", RES_TYPE_NUMBER);
1249   x_default_parameter (f, parms, Qbuffer_predicate, Qnil, "bufferPredicate",
1250                        "BufferPredicate", RES_TYPE_SYMBOL);
1251   x_default_parameter (f, parms, Qtitle, Qnil, "title", "Title",
1252                        RES_TYPE_STRING);
1254 /* TODO: other terms seem to get away w/o this complexity.. */
1255   if (NILP (Fassq (Qwidth, parms)))
1256     {
1257       Lisp_Object value
1258          = x_get_arg (dpyinfo, parms, Qwidth, "width", "Width",
1259                       RES_TYPE_NUMBER);
1260       if (! EQ (value, Qunbound))
1261         parms = Fcons (Fcons (Qwidth, value), parms);
1262     }
1263   if (NILP (Fassq (Qheight, parms)))
1264     {
1265       Lisp_Object value
1266          = x_get_arg (dpyinfo, parms, Qheight, "height", "Height",
1267                       RES_TYPE_NUMBER);
1268       if (! EQ (value, Qunbound))
1269         parms = Fcons (Fcons (Qheight, value), parms);
1270     }
1271   if (NILP (Fassq (Qleft, parms)))
1272     {
1273       Lisp_Object value
1274          = x_get_arg (dpyinfo, parms, Qleft, "left", "Left", RES_TYPE_NUMBER);
1275       if (! EQ (value, Qunbound))
1276         parms = Fcons (Fcons (Qleft, value), parms);
1277     }
1278   if (NILP (Fassq (Qtop, parms)))
1279     {
1280       Lisp_Object value
1281          = x_get_arg (dpyinfo, parms, Qtop, "top", "Top", RES_TYPE_NUMBER);
1282       if (! EQ (value, Qunbound))
1283         parms = Fcons (Fcons (Qtop, value), parms);
1284     }
1286   window_prompting = x_figure_window_size (f, parms, 1);
1288   tem = x_get_arg (dpyinfo, parms, Qunsplittable, 0, 0, RES_TYPE_BOOLEAN);
1289   f->no_split = minibuffer_only || (!EQ (tem, Qunbound) && !EQ (tem, Qnil));
1291   /* NOTE: on other terms, this is done in set_mouse_color, however this
1292      was not getting called under Nextstep */
1293   f->output_data.ns->text_cursor = [NSCursor IBeamCursor];
1294   f->output_data.ns->nontext_cursor = [NSCursor arrowCursor];
1295   f->output_data.ns->modeline_cursor = [NSCursor pointingHandCursor];
1296   f->output_data.ns->hand_cursor = [NSCursor pointingHandCursor];
1297   f->output_data.ns->hourglass_cursor = [NSCursor disappearingItemCursor];
1298   f->output_data.ns->horizontal_drag_cursor = [NSCursor resizeLeftRightCursor];
1299   FRAME_NS_DISPLAY_INFO (f)->vertical_scroll_bar_cursor
1300      = [NSCursor arrowCursor];
1301   f->output_data.ns->current_pointer = f->output_data.ns->text_cursor;
1303   [[EmacsView alloc] initFrameFromEmacs: f];
1305   x_icon (f, parms);
1307   /* It is now ok to make the frame official even if we get an error below.
1308      The frame needs to be on Vframe_list or making it visible won't work. */
1309   Vframe_list = Fcons (frame, Vframe_list);
1310   /*FRAME_NS_DISPLAY_INFO (f)->reference_count++; */
1312   x_default_parameter (f, parms, Qicon_type, Qnil, "bitmapIcon", "BitmapIcon",
1313                       RES_TYPE_SYMBOL);
1314   x_default_parameter (f, parms, Qauto_raise, Qnil, "autoRaise", "AutoRaiseLower",
1315                       RES_TYPE_BOOLEAN);
1316   x_default_parameter (f, parms, Qauto_lower, Qnil, "autoLower", "AutoLower",
1317                       RES_TYPE_BOOLEAN);
1318   x_default_parameter (f, parms, Qcursor_type, Qbox, "cursorType", "CursorType",
1319                       RES_TYPE_SYMBOL);
1320   x_default_parameter (f, parms, Qscroll_bar_width, Qnil, "scrollBarWidth",
1321                       "ScrollBarWidth", RES_TYPE_NUMBER);
1322   x_default_parameter (f, parms, Qalpha, Qnil, "alpha", "Alpha",
1323                       RES_TYPE_NUMBER);
1325   width = FRAME_COLS (f);
1326   height = FRAME_LINES (f);
1328   SET_FRAME_COLS (f, 0);
1329   FRAME_LINES (f) = 0;
1330   change_frame_size (f, height, width, 1, 0, 0);
1332   if (! f->output_data.ns->explicit_parent)
1333     {
1334         tem = x_get_arg (dpyinfo, parms, Qvisibility, 0, 0, RES_TYPE_BOOLEAN);
1335         if (EQ (tem, Qunbound))
1336             tem = Qnil;
1338         x_set_visibility (f, tem, Qnil);
1339         if (EQ (tem, Qt))
1340             [[FRAME_NS_VIEW (f) window] makeKeyWindow];
1341     }
1343   if (FRAME_HAS_MINIBUF_P (f)
1344       && (!FRAMEP (kb->Vdefault_minibuffer_frame)
1345           || !FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame))))
1346     kb->Vdefault_minibuffer_frame = frame;
1348   /* All remaining specified parameters, which have not been "used"
1349      by x_get_arg and friends, now go in the misc. alist of the frame.  */
1350   for (tem = parms; CONSP (tem); tem = XCDR (tem))
1351     if (CONSP (XCAR (tem)) && !NILP (XCAR (XCAR (tem))))
1352       f->param_alist = Fcons (XCAR (tem), f->param_alist);
1354   UNGCPRO;
1355   Vwindow_list = Qnil;
1357   return unbind_to (count, frame);
1361 DEFUN ("x-focus-frame", Fx_focus_frame, Sx_focus_frame, 1, 1, 0,
1362        doc: /* Set the input focus to FRAME.
1363 FRAME nil means use the selected frame.  */)
1364      (frame)
1365      Lisp_Object frame;
1367   struct frame *f = check_ns_frame (frame);
1368   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (f);
1370   if (dpyinfo->x_focus_frame != f)
1371     {
1372       EmacsView *view = FRAME_NS_VIEW (f);
1373       BLOCK_INPUT;
1374       [[view window] makeKeyAndOrderFront: view];
1375       UNBLOCK_INPUT;
1376     }
1378   return Qnil;
1382 DEFUN ("ns-popup-prefs-panel", Fns_popup_prefs_panel, Sns_popup_prefs_panel,
1383        0, 0, "",
1384        doc: /* Pop up the preferences panel. */)
1385      ()
1387   check_ns ();
1388   [(EmacsApp *)NSApp showPreferencesWindow: NSApp];
1389   return Qnil;
1393 DEFUN ("ns-popup-font-panel", Fns_popup_font_panel, Sns_popup_font_panel,
1394        0, 1, "",
1395        doc: /* Pop up the font panel. */)
1396      (frame)
1397      Lisp_Object frame;
1399   id fm;
1400   struct frame *f;
1402   check_ns ();
1403   fm = [NSFontManager new];
1404   if (NILP (frame))
1405     f = SELECTED_FRAME ();
1406   else
1407     {
1408       CHECK_FRAME (frame);
1409       f = XFRAME (frame);
1410     }
1412   [fm setSelectedFont: ((struct nsfont_info *)f->output_data.ns->font)->nsfont
1413            isMultiple: NO];
1414   [fm orderFrontFontPanel: NSApp];
1415   return Qnil;
1419 DEFUN ("ns-popup-color-panel", Fns_popup_color_panel, Sns_popup_color_panel, 
1420        0, 1, "",
1421        doc: /* Pop up the color panel.  */)
1422      (frame)
1423      Lisp_Object frame;
1425   struct frame *f;
1427   check_ns ();
1428   if (NILP (frame))
1429     f = SELECTED_FRAME ();
1430   else
1431     {
1432       CHECK_FRAME (frame);
1433       f = XFRAME (frame);
1434     }
1436   [NSApp orderFrontColorPanel: NSApp];
1437   return Qnil;
1441 DEFUN ("ns-read-file-name", Fns_read_file_name, Sns_read_file_name, 1, 4, 0,
1442        doc: /* Use a graphical panel to read a file name, using prompt PROMPT.
1443 Optional arg DIR, if non-nil, supplies a default directory.
1444 Optional arg ISLOAD, if non-nil, means read a file name for saving.
1445 Optional arg INIT, if non-nil, provides a default file name to use.  */)
1446      (prompt, dir, isLoad, init)
1447      Lisp_Object prompt, dir, isLoad, init;
1449   static id fileDelegate = nil;
1450   int ret;
1451   id panel;
1452   Lisp_Object fname;
1454   NSString *promptS = NILP (prompt) || !STRINGP (prompt) ? nil :
1455     [NSString stringWithUTF8String: SDATA (prompt)];
1456   NSString *dirS = NILP (dir) || !STRINGP (dir) ?
1457     [NSString stringWithUTF8String: SDATA (current_buffer->directory)] :
1458     [NSString stringWithUTF8String: SDATA (dir)];
1459   NSString *initS = NILP (init) || !STRINGP (init) ? nil :
1460     [NSString stringWithUTF8String: SDATA (init)];
1462   check_ns ();
1464   if (fileDelegate == nil)
1465     fileDelegate = [EmacsFileDelegate new];
1467   [NSCursor setHiddenUntilMouseMoves: NO];
1469   if ([dirS characterAtIndex: 0] == '~')
1470     dirS = [dirS stringByExpandingTildeInPath];
1472   panel = NILP (isLoad) ?
1473     (id)[EmacsSavePanel savePanel] : (id)[EmacsOpenPanel openPanel];
1475   [panel setTitle: promptS];
1477   /* Puma (10.1) does not have */
1478   if ([panel respondsToSelector: @selector (setAllowsOtherFileTypes:)])
1479     [panel setAllowsOtherFileTypes: YES];
1481   [panel setTreatsFilePackagesAsDirectories: YES];
1482   [panel setDelegate: fileDelegate];
1484   panelOK = 0;
1485   BLOCK_INPUT;
1486   if (NILP (isLoad))
1487     {
1488       ret = [panel runModalForDirectory: dirS file: initS];
1489     }
1490   else
1491     {
1492       [panel setCanChooseDirectories: YES];
1493       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1494     }
1496   ret = (ret == NSOKButton) || panelOK;
1498   if (ret)
1499     fname = build_string ([[panel filename] UTF8String]);
1500   
1501   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1502   UNBLOCK_INPUT;
1504   return ret ? fname : Qnil;
1508 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1509        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1510 If OWNER is nil, Emacs is assumed.  */)
1511      (owner, name)
1512      Lisp_Object owner, name;
1514   const char *value;
1516   check_ns ();
1517   if (NILP (owner))
1518     owner = build_string
1519         ([[[NSProcessInfo processInfo] processName] UTF8String]);
1520   /* CHECK_STRING (owner);  this should be just "Emacs" */
1521   CHECK_STRING (name);
1522 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1524   value =[[[NSUserDefaults standardUserDefaults]
1525             objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1526            UTF8String];
1528   if (value)
1529     return build_string (value);
1530   return Qnil;
1534 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1535        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1536 If OWNER is nil, Emacs is assumed.
1537 If VALUE is nil, the default is removed.  */)
1538      (owner, name, value)
1539      Lisp_Object owner, name, value;
1541   check_ns ();
1542   if (NILP (owner))
1543     owner
1544        = build_string ([[[NSProcessInfo processInfo] processName] UTF8String]);
1545   CHECK_STRING (owner);
1546   CHECK_STRING (name);
1547   if (NILP (value))
1548     {
1549       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1550                          [NSString stringWithUTF8String: SDATA (name)]];
1551     }
1552   else
1553     {
1554       CHECK_STRING (value);
1555       [[NSUserDefaults standardUserDefaults] setObject:
1556                 [NSString stringWithUTF8String: SDATA (value)]
1557                                         forKey: [NSString stringWithUTF8String:
1558                                                          SDATA (name)]];
1559     }
1561   return Qnil;
1565 DEFUN ("ns-set-alpha", Fns_set_alpha, Sns_set_alpha, 2, 2, 0,
1566        doc: /* Return a color equivalent to COLOR with alpha setting ALPHA.
1567 The argument ALPHA should be a number between 0 and 1, where 0 is full
1568 transparency and 1 is opaque.  */)
1569      (color, alpha)
1570      Lisp_Object color;
1571      Lisp_Object alpha;
1573   NSColor *col;
1574   float a;
1576   CHECK_STRING (color);
1577   CHECK_NUMBER_OR_FLOAT (alpha);
1579   if (ns_lisp_to_color (color, &col))
1580     error ("Unknown color.");
1582   a = XFLOATINT (alpha);
1583   if (a < 0.0 || a > 1.0)
1584     error ("Alpha value should be between 0 and 1 inclusive.");
1586   col = [col colorWithAlphaComponent: a];
1587   return ns_color_to_lisp (col);
1591 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1592        Sx_server_max_request_size,
1593        0, 1, 0,
1594        doc: /* This function is a no-op.  It is only present for completeness.  */)
1595      (display)
1596      Lisp_Object display;
1598   check_ns ();
1599   /* This function has no real equivalent under NeXTstep.  Return nil to
1600      indicate this. */
1601   return Qnil;
1605 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1606        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1607 DISPLAY should be either a frame or a display name (a string).
1608 If omitted or nil, the selected frame's display is used.  */)
1609      (display)
1610      Lisp_Object display;
1612 #ifdef NS_IMPL_GNUSTEP
1613   return build_string ("GNU");
1614 #else
1615   return build_string ("Apple");
1616 #endif
1620 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1621        doc: /* Return the version numbers of the server of DISPLAY.
1622 The value is a list of three integers: the major and minor
1623 version numbers of the X Protocol in use, and the distributor-specific
1624 release number.  See also the function `x-server-vendor'.
1626 The optional argument DISPLAY specifies which display to ask about.
1627 DISPLAY should be either a frame or a display name (a string).
1628 If omitted or nil, that stands for the selected frame's display.  */)
1629      (display)
1630      Lisp_Object display;
1632   /*NOTE: it is unclear what would best correspond with "protocol";
1633           we return 10.3, meaning Panther, since this is roughly the
1634           level that GNUstep's APIs correspond to.
1635           The last number is where we distinguish between the Apple
1636           and GNUstep implementations ("distributor-specific release
1637           number") and give int'ized versions of major.minor. */
1638   return Fcons (make_number (10),
1639                 Fcons (make_number (3),
1640                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1644 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1645        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1646 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1647 If omitted or nil, the selected frame's display is used.  */)
1648      (display)
1649      Lisp_Object display;
1651   int num;
1653   check_ns ();
1654   num = [[NSScreen screens] count];
1656   return (num != 0) ? make_number (num) : Qnil;
1660 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1661        0, 1, 0,
1662        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1663 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1664 If omitted or nil, the selected frame's display is used.  */)
1665      (display)
1666      Lisp_Object display;
1668   check_ns ();
1669   return make_number ((int)
1670                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1674 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1675        0, 1, 0,
1676        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1677 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1678 If omitted or nil, the selected frame's display is used.  */)
1679      (display)
1680      Lisp_Object display;
1682   check_ns ();
1683   return make_number ((int)
1684                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1688 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1689        Sx_display_backing_store, 0, 1, 0,
1690        doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1691 The value may be `buffered', `retained', or `non-retained'.
1692 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1693 If omitted or nil, the selected frame's display is used.  */)
1694      (display)
1695      Lisp_Object display;
1697   check_ns ();
1698   switch ([ns_get_window (display) backingType])
1699     {
1700     case NSBackingStoreBuffered:
1701       return intern ("buffered");
1702     case NSBackingStoreRetained:
1703       return intern ("retained");
1704     case NSBackingStoreNonretained:
1705       return intern ("non-retained");
1706     default:
1707       error ("Strange value for backingType parameter of frame");
1708     }
1709   return Qnil;  /* not reached, shut compiler up */
1713 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1714        Sx_display_visual_class, 0, 1, 0,
1715        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1716 The value is one of the symbols `static-gray', `gray-scale',
1717 `static-color', `pseudo-color', `true-color', or `direct-color'.
1718 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1719 If omitted or nil, the selected frame's display is used.  */)
1720      (display)
1721      Lisp_Object display;
1723   NSWindowDepth depth;
1724   check_ns ();
1725   depth = [ns_get_screen (display) depth];
1727   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1728     return intern ("static-gray");
1729   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1730     return intern ("gray-scale");
1731   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1732     return intern ("pseudo-color");
1733   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1734     return intern ("true-color");
1735   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1736     return intern ("direct-color");
1737   else
1738     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1739     return intern ("direct-color");
1743 DEFUN ("x-display-save-under", Fx_display_save_under,
1744        Sx_display_save_under, 0, 1, 0,
1745        doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1746 The optional argument DISPLAY specifies which display to ask about.
1747 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1748 If omitted or nil, the selected frame's display is used.  */)
1749      (display)
1750      Lisp_Object display;
1752   check_ns ();
1753   switch ([ns_get_window (display) backingType])
1754     {
1755     case NSBackingStoreBuffered:
1756       return Qt;
1758     case NSBackingStoreRetained:
1759     case NSBackingStoreNonretained:
1760       return Qnil;
1762     default:
1763       error ("Strange value for backingType parameter of frame");
1764     }
1765   return Qnil;  /* not reached, shut compiler up */
1769 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1770        1, 3, 0,
1771        doc: /* Open a connection to a Nextstep display server.
1772 DISPLAY is the name of the display to connect to.
1773 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored.  */)
1774      (display, resource_string, must_succeed)
1775      Lisp_Object display, resource_string, must_succeed;
1777   struct ns_display_info *dpyinfo;
1779   CHECK_STRING (display);
1781   nxatoms_of_nsselect ();
1782   dpyinfo = ns_term_init (display);
1783   if (dpyinfo == 0)
1784     {
1785       if (!NILP (must_succeed))
1786         fatal ("OpenStep on %s not responding.\n",
1787                SDATA (display));
1788       else
1789         error ("OpenStep on %s not responding.\n",
1790                SDATA (display));
1791     }
1793   /* Register our external input/output types, used for determining
1794      applicable services and also drag/drop eligibility. */
1795   ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1796   ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1797   ns_drag_types = [[NSArray arrayWithObjects:
1798                             NSStringPboardType,
1799                             NSTabularTextPboardType,
1800                             NSFilenamesPboardType,
1801                             NSURLPboardType,
1802                             NSColorPboardType,
1803                             NSFontPboardType, nil] retain];
1805   return Qnil;
1809 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1810        1, 1, 0,
1811        doc: /* Close the connection to the current Nextstep display server.
1812 The second argument DISPLAY is currently ignored.  */)
1813      (display)
1814      Lisp_Object display;
1816   check_ns ();
1817 #ifdef NS_IMPL_COCOA
1818   PSFlush ();
1819 #endif
1820   /*ns_delete_terminal (dpyinfo->terminal); */
1821   [NSApp terminate: NSApp];
1822   return Qnil;
1826 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1827        doc: /* Return the list of display names that Emacs has connections to.  */)
1828      ()
1830   Lisp_Object tail, result;
1832   result = Qnil;
1833   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1834     result = Fcons (XCAR (XCAR (tail)), result);
1836   return result;
1840 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1841        0, 0, 0,
1842        doc: /* Hides all applications other than emacs.  */)
1843      ()
1845   check_ns ();
1846   [NSApp hideOtherApplications: NSApp];
1847   return Qnil;
1850 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1851        1, 1, 0,
1852        doc: /* If ON is non-nil, the entire emacs application is hidden.
1853 Otherwise if emacs is hidden, it is unhidden.
1854 If ON is equal to `activate', emacs is unhidden and becomes
1855 the active application.  */)
1856      (on)
1857      Lisp_Object on;
1859   check_ns ();
1860   if (EQ (on, intern ("activate")))
1861     {
1862       [NSApp unhide: NSApp];
1863       [NSApp activateIgnoringOtherApps: YES];
1864     }
1865   else if (NILP (on))
1866     [NSApp unhide: NSApp];
1867   else
1868     [NSApp hide: NSApp];
1869   return Qnil;
1873 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1874        0, 0, 0,
1875        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1876      ()
1878   check_ns ();
1879   [NSApp orderFrontStandardAboutPanel: nil];
1880   return Qnil;
1884 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1885        doc: /* Determine font postscript or family name for font NAME.
1886 NAME should be a string containing either the font name or an XLFD
1887 font descriptor.  If string contains `fontset' and not
1888 `fontset-startup', it is left alone. */)
1889      (name)
1890      Lisp_Object name;
1892   char *nm;
1893   CHECK_STRING (name);
1894   nm = SDATA (name);
1896   if (nm[0] != '-')
1897     return name;
1898   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1899     return name;
1901   return build_string (ns_xlfd_to_fontname (SDATA (name)));
1905 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1906        doc: /* Return a list of all available colors.
1907 The optional argument FRAME is currently ignored.  */)
1908      (frame)
1909      Lisp_Object frame;
1911   Lisp_Object list = Qnil;
1912   NSEnumerator *colorlists;
1913   NSColorList *clist;
1915   if (!NILP (frame))
1916     {
1917       CHECK_FRAME (frame);
1918       if (! FRAME_NS_P (XFRAME (frame)))
1919         error ("non-Nextstep frame used in `ns-list-colors'");
1920     }
1922   BLOCK_INPUT;
1924   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1925   while (clist = [colorlists nextObject])
1926     {
1927       if ([[clist name] length] < 7 ||
1928           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1929         {
1930           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1931           NSString *cname;
1932           while (cname = [cnames nextObject])
1933             list = Fcons (build_string ([cname UTF8String]), list);
1934 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1935                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1936                                              UTF8String]), list); */
1937         }
1938     }
1940   UNBLOCK_INPUT;
1942   return list;
1946 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1947        doc: /* List available Nextstep services by querying NSApp.  */)
1948      ()
1950   Lisp_Object ret = Qnil;
1951   NSMenu *svcs;
1952   id delegate;
1954   check_ns ();
1955   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1956   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
1957   [NSApp registerServicesMenuSendTypes: ns_send_types
1958                            returnTypes: ns_return_types];
1960 /* On Tiger, services menu updating was made lazier (waits for user to
1961    actually click on the menu), so we have to force things along: */
1962 #ifdef NS_IMPL_COCOA
1963   if (NSAppKitVersionNumber >= 744.0)
1964     {
1965       delegate = [svcs delegate];
1966       if (delegate != nil)
1967         {
1968           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1969               [delegate menuNeedsUpdate: svcs];
1970           if ([delegate respondsToSelector:
1971                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1972             {
1973               int i, len = [delegate numberOfItemsInMenu: svcs];
1974               for (i =0; i<len; i++)
1975                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1976               for (i =0; i<len; i++)
1977                   if (![delegate menu: svcs
1978                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1979                               atIndex: i shouldCancel: NO])
1980                     break;
1981             }
1982         }
1983     }
1984 #endif
1986   [svcs setAutoenablesItems: NO];
1987 #ifdef NS_IMPL_COCOA
1988   [svcs update]; /* on OS X, converts from '/' structure */
1989 #endif
1991   ret = interpret_services_menu (svcs, Qnil, ret);
1992   return ret;
1996 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1997        2, 2, 0,
1998        doc: /* Perform Nextstep SERVICE on SEND.
1999 SEND should be either a string or nil.
2000 The return value is the result of the service, as string, or nil if
2001 there was no result.  */)
2002      (service, send)
2003      Lisp_Object service, send;
2005   id pb;
2006   NSString *svcName;
2007   char *utfStr;
2008   int len;
2010   CHECK_STRING (service);
2011   check_ns ();
2013   utfStr = SDATA (service);
2014   svcName = [NSString stringWithUTF8String: utfStr];
2016   pb =[NSPasteboard pasteboardWithUniqueName];
2017   ns_string_to_pasteboard (pb, send);
2019   if (NSPerformService (svcName, pb) == NO)
2020     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2022   if ([[pb types] count] == 0)
2023     return build_string ("");
2024   return ns_string_from_pasteboard (pb);
2028 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2029        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2030        doc: /* Return an NFC string that matches  the UTF-8 NFD string STR.  */)
2031     (str)
2032     Lisp_Object str;
2034 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2035          remove this. */
2036   NSString *utfStr;
2038   CHECK_STRING (str);
2039   utfStr = [NSString stringWithUTF8String: SDATA (str)];
2040   if (![utfStr respondsToSelector:
2041                  @selector (precomposedStringWithCanonicalMapping)])
2042     {
2043       message1
2044         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2045       return Qnil;
2046     }
2047   else
2048     utfStr = [utfStr precomposedStringWithCanonicalMapping];
2049   return build_string ([utfStr UTF8String]);
2053 #ifdef NS_IMPL_COCOA
2055 /* Compile and execute the AppleScript SCRIPT and return the error
2056    status as function value.  A zero is returned if compilation and
2057    execution is successful, in which case *RESULT is set to a Lisp
2058    string or a number containing the resulting script value.  Otherwise,
2059    1 is returned. */
2060 static int
2061 ns_do_applescript (script, result)
2062      Lisp_Object script, *result;
2064   NSAppleEventDescriptor *desc;
2065   NSDictionary* errorDict;
2066   NSAppleEventDescriptor* returnDescriptor = NULL;
2068   NSAppleScript* scriptObject =
2069     [[NSAppleScript alloc] initWithSource:
2070                              [NSString stringWithUTF8String: SDATA (script)]];
2072   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2073   [scriptObject release];
2074   
2075   *result = Qnil;
2076   
2077   if (returnDescriptor != NULL)
2078     {
2079       // successful execution
2080       if (kAENullEvent != [returnDescriptor descriptorType])
2081         {
2082           *result = Qt;
2083           // script returned an AppleScript result
2084           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2085 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2086               (typeUTF16ExternalRepresentation 
2087                == [returnDescriptor descriptorType]) ||
2088 #endif
2089               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2090               (typeCString == [returnDescriptor descriptorType]))
2091             {
2092               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2093               if (desc)
2094                 *result = build_string([[desc stringValue] UTF8String]);
2095             }
2096           else
2097             {
2098               /* use typeUTF16ExternalRepresentation? */
2099               // coerce the result to the appropriate ObjC type
2100               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2101               if (desc)
2102                 *result = make_number([desc int32Value]);
2103             }
2104         }
2105     }
2106   else
2107     {
2108       // no script result, return error
2109       return 1;
2110     }
2111   return 0;
2114 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2115        doc: /* Execute AppleScript SCRIPT and return the result.  If
2116 compilation and execution are successful, the resulting script value
2117 is returned as a string, a number or, in the case of other constructs,
2118 t.  In case the execution fails, an error is signaled. */)
2119     (script)
2120     Lisp_Object script;
2122   Lisp_Object result;
2123   long status;
2125   CHECK_STRING (script);
2126   check_ns ();
2128   BLOCK_INPUT;
2129   status = ns_do_applescript (script, &result);
2130   UNBLOCK_INPUT;
2131   if (status == 0)
2132     return result;
2133   else if (!STRINGP (result))
2134     error ("AppleScript error %d", status);
2135   else
2136     error ("%s", SDATA (result));
2138 #endif
2142 /* ==========================================================================
2144     Miscellaneous functions not called through hooks
2146    ========================================================================== */
2149 /* called from image.c */
2150 FRAME_PTR
2151 check_x_frame (Lisp_Object frame)
2153   return check_ns_frame (frame);
2157 /* called from frame.c */
2158 struct ns_display_info *
2159 check_x_display_info (Lisp_Object frame)
2161   return check_ns_display_info (frame);
2165 void
2166 x_set_scroll_bar_default_width (f)
2167      struct frame *f;
2169   int wid = FRAME_COLUMN_WIDTH (f);
2170   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2171   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2172                                       wid - 1) / wid;
2176 /* terms impl this instead of x-get-resource directly */
2177 const char *
2178 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2180   /* remove appname prefix; TODO: allow for !="Emacs" */
2181   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2182   const char *res;
2183   check_ns ();
2185   /* Support emacs-20-style face resources for backwards compatibility */
2186   if (!strncmp (toCheck, "Face", 4))
2187     toCheck = name + (!strncmp (name, "emacs.", 6) ? 6 : 0);
2189 /*fprintf (stderr, "Checking '%s'\n", toCheck); */
2191   res = ns_no_defaults ? NULL :
2192     [[[NSUserDefaults standardUserDefaults] objectForKey:
2193                      [NSString stringWithUTF8String: toCheck]] UTF8String];
2194   return !res ? NULL :
2195       (!strncasecmp (res, "YES", 3) ? "true" :
2196           (!strncasecmp (res, "NO", 2) ? "false" : res));
2200 Lisp_Object
2201 x_get_focus_frame (struct frame *frame)
2203   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2204   Lisp_Object nsfocus;
2206   if (!dpyinfo->x_focus_frame)
2207     return Qnil;
2209   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2210   return nsfocus;
2215 x_pixel_width (struct frame *f)
2217   return FRAME_PIXEL_WIDTH (f);
2222 x_pixel_height (struct frame *f)
2224   return FRAME_PIXEL_HEIGHT (f);
2229 x_char_width (struct frame *f)
2231   return FRAME_COLUMN_WIDTH (f);
2236 x_char_height (struct frame *f)
2238   return FRAME_LINE_HEIGHT (f);
2243 x_screen_planes (struct frame *f)
2245   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2249 void
2250 x_sync (Lisp_Object frame)
2252   /* XXX Not implemented XXX */
2253   return;
2258 /* ==========================================================================
2260     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2262    ========================================================================== */
2265 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2266        doc: /* Return t if the current Nextstep display supports the color COLOR.
2267 The optional argument FRAME is currently ignored.  */)
2268      (color, frame)
2269      Lisp_Object color, frame;
2271   NSColor * col;
2272   check_ns ();
2273   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2277 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2278        doc: /* Return a description of the color named COLOR.
2279 The value is a list of integer RGBA values--(RED GREEN BLUE ALPHA).
2280 These values appear to range from 0 to 65280; white is (65280 65280 65280 0).
2281 The optional argument FRAME is currently ignored.  */)
2282      (color, frame)
2283      Lisp_Object color, frame;
2285   NSColor * col;
2286   float red, green, blue, alpha;
2287   Lisp_Object rgba[4];
2289   check_ns ();
2290   CHECK_STRING (color);
2292   if (ns_lisp_to_color (color, &col))
2293     return Qnil;
2295   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2296         getRed: &red green: &green blue: &blue alpha: &alpha];
2297   rgba[0] = make_number (lrint (red*65280));
2298   rgba[1] = make_number (lrint (green*65280));
2299   rgba[2] = make_number (lrint (blue*65280));
2300   rgba[3] = make_number (lrint (alpha*65280));
2302   return Flist (4, rgba);
2306 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2307        doc: /* Return t if the Nextstep display supports color.
2308 The optional argument DISPLAY specifies which display to ask about.
2309 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2310 If omitted or nil, that stands for the selected frame's display.  */)
2311      (display)
2312      Lisp_Object display;
2314   NSWindowDepth depth;
2315   NSString *colorSpace;
2316   check_ns ();
2317   depth = [ns_get_screen (display) depth];
2318   colorSpace = NSColorSpaceFromDepth (depth);
2320   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2321          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2322       ? Qnil : Qt;
2326 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2327        Sx_display_grayscale_p, 0, 1, 0,
2328        doc: /* Return t if the Nextstep display supports shades of gray.
2329 Note that color displays do support shades of gray.
2330 The optional argument DISPLAY specifies which display to ask about.
2331 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2332 If omitted or nil, that stands for the selected frame's display. */)
2333      (display)
2334      Lisp_Object display;
2336   NSWindowDepth depth;
2337   check_ns ();
2338   depth = [ns_get_screen (display) depth];
2340   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2344 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2345        0, 1, 0,
2346        doc: /* Returns the width in pixels of the Nextstep display DISPLAY.
2347 The optional argument DISPLAY specifies which display to ask about.
2348 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2349 If omitted or nil, that stands for the selected frame's display.  */)
2350      (display)
2351      Lisp_Object display;
2353   check_ns ();
2354   return make_number ((int) [ns_get_screen (display) frame].size.width);
2358 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2359        Sx_display_pixel_height, 0, 1, 0,
2360        doc: /* Returns the height in pixels of the Nextstep display DISPLAY.
2361 The optional argument DISPLAY specifies which display to ask about.
2362 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2363 If omitted or nil, that stands for the selected frame's display.  */)
2364      (display)
2365      Lisp_Object display;
2367   check_ns ();
2368   return make_number ((int) [ns_get_screen (display) frame].size.height);
2372 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2373        Sns_display_usable_bounds, 0, 1, 0,
2374        doc: /*Return the bounds of the usable part of the screen.
2375 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2376 are the boundaries of the usable part of the screen, excluding areas
2377 reserved for the Mac menu, dock, and so forth.
2379 The screen queried corresponds to DISPLAY, which should be either a
2380 frame, a display name (a string), or terminal ID.  If omitted or nil,
2381 that stands for the selected frame's display. */)
2382      (display)
2383      Lisp_Object display;
2385   int top;
2386   NSRect vScreen;
2388   check_ns ();
2389   vScreen = [ns_get_screen (display) visibleFrame];
2390   top = vScreen.origin.y == 0.0 ?
2391     (int) [ns_get_screen (display) frame].size.height - vScreen.size.height : 0;
2393   return list4 (make_number ((int) vScreen.origin.x),
2394                 make_number (top),
2395                 make_number ((int) vScreen.size.width),
2396                 make_number ((int) vScreen.size.height));
2400 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2401        0, 1, 0,
2402        doc: /* Returns the number of bitplanes of the Nextstep display DISPLAY.
2403 The optional argument DISPLAY specifies which display to ask about.
2404 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2405 If omitted or nil, that stands for the selected frame's display.  */)
2406      (display)
2407      Lisp_Object display;
2409   check_ns ();
2410   return make_number
2411     (NSBitsPerSampleFromDepth ([ns_get_screen (display) depth]));
2415 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2416        Sx_display_color_cells, 0, 1, 0,
2417        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2418 The optional argument DISPLAY specifies which display to ask about.
2419 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2420 If omitted or nil, that stands for the selected frame's display.  */)
2421      (display)
2422      Lisp_Object display;
2424   check_ns ();
2425   struct ns_display_info *dpyinfo = check_ns_display_info (display);
2427   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2428   return make_number (1 << min (dpyinfo->n_planes, 24));
2432 /* Unused dummy def needed for compatibility. */
2433 Lisp_Object tip_frame;
2435 /* TODO: move to xdisp or similar */
2436 static void
2437 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2438      struct frame *f;
2439      Lisp_Object parms, dx, dy;
2440      int width, height;
2441      int *root_x, *root_y;
2443   Lisp_Object left, top;
2444   EmacsView *view = FRAME_NS_VIEW (f);
2445   NSPoint pt;
2446   
2447   /* Start with user-specified or mouse position.  */
2448   left = Fcdr (Fassq (Qleft, parms));
2449   if (INTEGERP (left))
2450     pt.x = XINT (left);
2451   else
2452     pt.x = last_mouse_motion_position.x;
2453   top = Fcdr (Fassq (Qtop, parms));
2454   if (INTEGERP (top))
2455     pt.y = XINT (top);
2456   else
2457     pt.y = last_mouse_motion_position.y;
2459   /* Convert to screen coordinates */
2460   pt = [view convertPoint: pt toView: nil];
2461   pt = [[view window] convertBaseToScreen: pt];
2463   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2464   if (pt.x + XINT (dx) <= 0)
2465     *root_x = 0; /* Can happen for negative dx */
2466   else if (pt.x + XINT (dx) + width
2467            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2468     /* It fits to the right of the pointer.  */
2469     *root_x = pt.x + XINT (dx);
2470   else if (width + XINT (dx) <= pt.x)
2471     /* It fits to the left of the pointer.  */
2472     *root_x = pt.x - width - XINT (dx);
2473   else
2474     /* Put it left justified on the screen -- it ought to fit that way.  */
2475     *root_x = 0;
2477   if (pt.y - XINT (dy) - height >= 0)
2478     /* It fits below the pointer.  */
2479     *root_y = pt.y - height - XINT (dy);
2480   else if (pt.y + XINT (dy) + height
2481            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2482     /* It fits above the pointer */
2483       *root_y = pt.y + XINT (dy);
2484   else
2485     /* Put it on the top.  */
2486     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2490 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2491        doc: /* Show STRING in a "tooltip" window on frame FRAME.
2492 A tooltip window is a small window displaying a string.
2494 FRAME nil or omitted means use the selected frame.
2496 PARMS is an optional list of frame parameters which can be used to
2497 change the tooltip's appearance.
2499 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2500 means use the default timeout of 5 seconds.
2502 If the list of frame parameters PARMS contains a `left' parameter,
2503 the tooltip is displayed at that x-position.  Otherwise it is
2504 displayed at the mouse position, with offset DX added (default is 5 if
2505 DX isn't specified).  Likewise for the y-position; if a `top' frame
2506 parameter is specified, it determines the y-position of the tooltip
2507 window, otherwise it is displayed at the mouse position, with offset
2508 DY added (default is -10).
2510 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2511 Text larger than the specified size is clipped.  */)
2512      (string, frame, parms, timeout, dx, dy)
2513      Lisp_Object string, frame, parms, timeout, dx, dy;
2515   int root_x, root_y;
2516   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2517   int count = SPECPDL_INDEX ();
2518   struct frame *f;
2519   char *str;
2520   NSSize size;
2522   specbind (Qinhibit_redisplay, Qt);
2524   GCPRO4 (string, parms, frame, timeout);
2526   CHECK_STRING (string);
2527   str = SDATA (string);
2528   f = check_x_frame (frame);
2529   if (NILP (timeout))
2530     timeout = make_number (5);
2531   else
2532     CHECK_NATNUM (timeout);
2534   if (NILP (dx))
2535     dx = make_number (5);
2536   else
2537     CHECK_NUMBER (dx);
2539   if (NILP (dy))
2540     dy = make_number (-10);
2541   else
2542     CHECK_NUMBER (dy);
2544   BLOCK_INPUT;
2545   if (ns_tooltip == nil)
2546     ns_tooltip = [[EmacsTooltip alloc] init];
2547   else
2548     Fx_hide_tip ();
2550   [ns_tooltip setText: str];
2551   size = [ns_tooltip frame].size;
2553   /* Move the tooltip window where the mouse pointer is.  Resize and
2554      show it.  */
2555   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2556                   &root_x, &root_y);
2558   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2559   UNBLOCK_INPUT;
2561   UNGCPRO;
2562   return unbind_to (count, Qnil);
2566 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2567        doc: /* Hide the current tooltip window, if there is any.
2568 Value is t if tooltip was open, nil otherwise.  */)
2569      ()
2571   if (ns_tooltip == nil || ![ns_tooltip isActive])
2572     return Qnil;
2573   [ns_tooltip hide];
2574   return Qt;
2578 /* ==========================================================================
2580     Class implementations
2582    ========================================================================== */
2585 @implementation EmacsSavePanel
2586 #ifdef NS_IMPL_COCOA
2587 /* --------------------------------------------------------------------------
2588    These are overridden to intercept on OS X: ending panel restarts NSApp
2589    event loop if it is stopped.  Not sure if this is correct behavior,
2590    perhaps should check if running and if so send an appdefined.
2591    -------------------------------------------------------------------------- */
2592 - (void) ok: (id)sender
2594   [super ok: sender];
2595   panelOK = 1;
2596   [NSApp stop: self];
2598 - (void) cancel: (id)sender
2600   [super cancel: sender];
2601   [NSApp stop: self];
2603 #endif
2604 @end
2607 @implementation EmacsOpenPanel
2608 #ifdef NS_IMPL_COCOA
2609 /* --------------------------------------------------------------------------
2610    These are overridden to intercept on OS X: ending panel restarts NSApp
2611    event loop if it is stopped.  Not sure if this is correct behavior,
2612    perhaps should check if running and if so send an appdefined.
2613    -------------------------------------------------------------------------- */
2614 - (void) ok: (id)sender
2616   [super ok: sender];
2617   panelOK = 1;
2618   [NSApp stop: self];
2620 - (void) cancel: (id)sender
2622   [super cancel: sender];
2623   [NSApp stop: self];
2625 #endif
2626 @end
2629 @implementation EmacsFileDelegate
2630 /* --------------------------------------------------------------------------
2631    Delegate methods for Open/Save panels
2632    -------------------------------------------------------------------------- */
2633 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2635   return YES;
2637 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2639   return YES;
2641 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2642           confirmed: (BOOL)okFlag
2644   return filename;
2646 @end
2648 #endif
2651 /* ==========================================================================
2653     Lisp interface declaration
2655    ========================================================================== */
2658 void
2659 syms_of_nsfns ()
2661   int i;
2663   Qnone = intern ("none");
2664   staticpro (&Qnone);
2665   /* FIXME: Because of the typo below, Qbuffered probably never did
2666      anything useful, so it might as well be removed. */
2667   Qbuffered = intern ("bufferd");
2668   staticpro (&Qbuffered);
2669   Qfontsize = intern ("fontsize");
2670   staticpro (&Qfontsize);
2672   DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2673                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2674 If the title of a frame matches REGEXP, then IMAGE.tiff is
2675 selected as the image of the icon representing the frame when it's
2676 miniaturized.  If an element is t, then Emacs tries to select an icon
2677 based on the filetype of the visited file.
2679 The images have to be installed in a folder called English.lproj in the
2680 Emacs folder.  You have to restart Emacs after installing new icons.
2682 Example: Install an icon Gnus.tiff and execute the following code
2684   (setq ns-icon-type-alist
2685         (append ns-icon-type-alist
2686                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2687                    . \"Gnus\"))))
2689 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2690 be used as the image of the icon representing the frame.  */);
2691   Vns_icon_type_alist = Fcons (Qt, Qnil);
2693   DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2694                doc: /* Toolkit version for NS Windowing.  */);
2695   Vns_version_string = ns_appkit_version_str ();
2697   defsubr (&Sns_read_file_name);
2698   defsubr (&Sns_get_resource);
2699   defsubr (&Sns_set_resource);
2700   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2701   defsubr (&Sx_display_grayscale_p);
2702   defsubr (&Sns_font_name);
2703   defsubr (&Sns_list_colors);
2704 #ifdef NS_IMPL_COCOA
2705   defsubr (&Sns_do_applescript);
2706 #endif
2707   defsubr (&Sxw_color_defined_p);
2708   defsubr (&Sxw_color_values);
2709   defsubr (&Sx_server_max_request_size);
2710   defsubr (&Sx_server_vendor);
2711   defsubr (&Sx_server_version);
2712   defsubr (&Sx_display_pixel_width);
2713   defsubr (&Sx_display_pixel_height);
2714   defsubr (&Sns_display_usable_bounds);
2715   defsubr (&Sx_display_mm_width);
2716   defsubr (&Sx_display_mm_height);
2717   defsubr (&Sx_display_screens);
2718   defsubr (&Sx_display_planes);
2719   defsubr (&Sx_display_color_cells);
2720   defsubr (&Sx_display_visual_class);
2721   defsubr (&Sx_display_backing_store);
2722   defsubr (&Sx_display_save_under);
2723   defsubr (&Sx_create_frame);
2724   defsubr (&Sns_set_alpha);
2725   defsubr (&Sx_open_connection);
2726   defsubr (&Sx_close_connection);
2727   defsubr (&Sx_display_list);
2729   defsubr (&Sns_hide_others);
2730   defsubr (&Sns_hide_emacs);
2731   defsubr (&Sns_emacs_info_panel);
2732   defsubr (&Sns_list_services);
2733   defsubr (&Sns_perform_service);
2734   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2735   defsubr (&Sx_focus_frame);
2736   defsubr (&Sns_popup_prefs_panel);
2737   defsubr (&Sns_popup_font_panel);
2738   defsubr (&Sns_popup_color_panel);
2740   defsubr (&Sx_show_tip);
2741   defsubr (&Sx_hide_tip);
2743   /* used only in fontset.c */
2744   check_window_system_func = check_ns;
2748 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642