newsticker: removed debugging message.
[emacs.git] / src / nsfns.m
blob218674d864bda5bb507c7031746cc1826f5df283
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   NSString *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   if (NILP (isLoad))
1486     {
1487       ret = [panel runModalForDirectory: dirS file: initS];
1488     }
1489   else
1490     {
1491       [panel setCanChooseDirectories: YES];
1492       ret = [panel runModalForDirectory: dirS file: initS types: nil];
1493     }
1495   ret = (ret == NSOKButton) || panelOK;
1497   fname = [panel filename];
1499   [[FRAME_NS_VIEW (SELECTED_FRAME ()) window] makeKeyWindow];
1501   return ret ? build_string ([fname UTF8String]) : Qnil;
1505 DEFUN ("ns-get-resource", Fns_get_resource, Sns_get_resource, 2, 2, 0,
1506        doc: /* Return the value of the property NAME of OWNER from the defaults database.
1507 If OWNER is nil, Emacs is assumed.  */)
1508      (owner, name)
1509      Lisp_Object owner, name;
1511   const char *value;
1513   check_ns ();
1514   if (NILP (owner))
1515     owner = build_string
1516         ([[[NSProcessInfo processInfo] processName] UTF8String]);
1517   /* CHECK_STRING (owner);  this should be just "Emacs" */
1518   CHECK_STRING (name);
1519 /*fprintf (stderr, "ns-get-resource checking resource '%s'\n", SDATA (name)); */
1521   value =[[[NSUserDefaults standardUserDefaults]
1522             objectForKey: [NSString stringWithUTF8String: SDATA (name)]]
1523            UTF8String];
1525   if (value)
1526     return build_string (value);
1527   return Qnil;
1531 DEFUN ("ns-set-resource", Fns_set_resource, Sns_set_resource, 3, 3, 0,
1532        doc: /* Set property NAME of OWNER to VALUE, from the defaults database.
1533 If OWNER is nil, Emacs is assumed.
1534 If VALUE is nil, the default is removed.  */)
1535      (owner, name, value)
1536      Lisp_Object owner, name, value;
1538   check_ns ();
1539   if (NILP (owner))
1540     owner
1541        = build_string ([[[NSProcessInfo processInfo] processName] UTF8String]);
1542   CHECK_STRING (owner);
1543   CHECK_STRING (name);
1544   if (NILP (value))
1545     {
1546       [[NSUserDefaults standardUserDefaults] removeObjectForKey:
1547                          [NSString stringWithUTF8String: SDATA (name)]];
1548     }
1549   else
1550     {
1551       CHECK_STRING (value);
1552       [[NSUserDefaults standardUserDefaults] setObject:
1553                 [NSString stringWithUTF8String: SDATA (value)]
1554                                         forKey: [NSString stringWithUTF8String:
1555                                                          SDATA (name)]];
1556     }
1558   return Qnil;
1562 DEFUN ("ns-set-alpha", Fns_set_alpha, Sns_set_alpha, 2, 2, 0,
1563        doc: /* Return a color equivalent to COLOR with alpha setting ALPHA.
1564 The argument ALPHA should be a number between 0 and 1, where 0 is full
1565 transparency and 1 is opaque.  */)
1566      (color, alpha)
1567      Lisp_Object color;
1568      Lisp_Object alpha;
1570   NSColor *col;
1571   float a;
1573   CHECK_STRING (color);
1574   CHECK_NUMBER_OR_FLOAT (alpha);
1576   if (ns_lisp_to_color (color, &col))
1577     error ("Unknown color.");
1579   a = XFLOATINT (alpha);
1580   if (a < 0.0 || a > 1.0)
1581     error ("Alpha value should be between 0 and 1 inclusive.");
1583   col = [col colorWithAlphaComponent: a];
1584   return ns_color_to_lisp (col);
1588 DEFUN ("x-server-max-request-size", Fx_server_max_request_size,
1589        Sx_server_max_request_size,
1590        0, 1, 0,
1591        doc: /* This function is a no-op.  It is only present for completeness.  */)
1592      (display)
1593      Lisp_Object display;
1595   check_ns ();
1596   /* This function has no real equivalent under NeXTstep.  Return nil to
1597      indicate this. */
1598   return Qnil;
1602 DEFUN ("x-server-vendor", Fx_server_vendor, Sx_server_vendor, 0, 1, 0,
1603        doc: /* Return the vendor ID string of Nextstep display server DISPLAY.
1604 DISPLAY should be either a frame or a display name (a string).
1605 If omitted or nil, the selected frame's display is used.  */)
1606      (display)
1607      Lisp_Object display;
1609 #ifdef NS_IMPL_GNUSTEP
1610   return build_string ("GNU");
1611 #else
1612   return build_string ("Apple");
1613 #endif
1617 DEFUN ("x-server-version", Fx_server_version, Sx_server_version, 0, 1, 0,
1618        doc: /* Return the version numbers of the server of DISPLAY.
1619 The value is a list of three integers: the major and minor
1620 version numbers of the X Protocol in use, and the distributor-specific
1621 release number.  See also the function `x-server-vendor'.
1623 The optional argument DISPLAY specifies which display to ask about.
1624 DISPLAY should be either a frame or a display name (a string).
1625 If omitted or nil, that stands for the selected frame's display.  */)
1626      (display)
1627      Lisp_Object display;
1629   /*NOTE: it is unclear what would best correspond with "protocol";
1630           we return 10.3, meaning Panther, since this is roughly the
1631           level that GNUstep's APIs correspond to.
1632           The last number is where we distinguish between the Apple
1633           and GNUstep implementations ("distributor-specific release
1634           number") and give int'ized versions of major.minor. */
1635   return Fcons (make_number (10),
1636                 Fcons (make_number (3),
1637                        Fcons (make_number (ns_appkit_version_int()), Qnil)));
1641 DEFUN ("x-display-screens", Fx_display_screens, Sx_display_screens, 0, 1, 0,
1642        doc: /* Return the number of screens on Nextstep display server DISPLAY.
1643 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1644 If omitted or nil, the selected frame's display is used.  */)
1645      (display)
1646      Lisp_Object display;
1648   int num;
1650   check_ns ();
1651   num = [[NSScreen screens] count];
1653   return (num != 0) ? make_number (num) : Qnil;
1657 DEFUN ("x-display-mm-height", Fx_display_mm_height, Sx_display_mm_height,
1658        0, 1, 0,
1659        doc: /* Return the height of Nextstep display server DISPLAY, in millimeters.
1660 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1661 If omitted or nil, the selected frame's display is used.  */)
1662      (display)
1663      Lisp_Object display;
1665   check_ns ();
1666   return make_number ((int)
1667                      ([ns_get_screen (display) frame].size.height/(92.0/25.4)));
1671 DEFUN ("x-display-mm-width", Fx_display_mm_width, Sx_display_mm_width,
1672        0, 1, 0,
1673        doc: /* Return the width of Nextstep display server DISPLAY, in millimeters.
1674 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1675 If omitted or nil, the selected frame's display is used.  */)
1676      (display)
1677      Lisp_Object display;
1679   check_ns ();
1680   return make_number ((int)
1681                      ([ns_get_screen (display) frame].size.width/(92.0/25.4)));
1685 DEFUN ("x-display-backing-store", Fx_display_backing_store,
1686        Sx_display_backing_store, 0, 1, 0,
1687        doc: /* Return whether the Nexstep display DISPLAY supports backing store.
1688 The value may be `buffered', `retained', or `non-retained'.
1689 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1690 If omitted or nil, the selected frame's display is used.  */)
1691      (display)
1692      Lisp_Object display;
1694   check_ns ();
1695   switch ([ns_get_window (display) backingType])
1696     {
1697     case NSBackingStoreBuffered:
1698       return intern ("buffered");
1699     case NSBackingStoreRetained:
1700       return intern ("retained");
1701     case NSBackingStoreNonretained:
1702       return intern ("non-retained");
1703     default:
1704       error ("Strange value for backingType parameter of frame");
1705     }
1706   return Qnil;  /* not reached, shut compiler up */
1710 DEFUN ("x-display-visual-class", Fx_display_visual_class,
1711        Sx_display_visual_class, 0, 1, 0,
1712        doc: /* Return the visual class of the Nextstep display server DISPLAY.
1713 The value is one of the symbols `static-gray', `gray-scale',
1714 `static-color', `pseudo-color', `true-color', or `direct-color'.
1715 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1716 If omitted or nil, the selected frame's display is used.  */)
1717      (display)
1718      Lisp_Object display;
1720   NSWindowDepth depth;
1721   check_ns ();
1722   depth = [ns_get_screen (display) depth];
1724   if ( depth == NSBestDepth (NSCalibratedWhiteColorSpace, 2, 2, YES, NULL))
1725     return intern ("static-gray");
1726   else if (depth == NSBestDepth (NSCalibratedWhiteColorSpace, 8, 8, YES, NULL))
1727     return intern ("gray-scale");
1728   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 8, YES, NULL))
1729     return intern ("pseudo-color");
1730   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 4, 12, NO, NULL))
1731     return intern ("true-color");
1732   else if ( depth == NSBestDepth (NSCalibratedRGBColorSpace, 8, 24, NO, NULL))
1733     return intern ("direct-color");
1734   else
1735     /* color mgmt as far as we do it is really handled by Nextstep itself anyway */
1736     return intern ("direct-color");
1740 DEFUN ("x-display-save-under", Fx_display_save_under,
1741        Sx_display_save_under, 0, 1, 0,
1742        doc: /* Non-nil if the Nextstep display server supports the save-under feature.
1743 The optional argument DISPLAY specifies which display to ask about.
1744 DISPLAY should be a frame, the display name as a string, or a terminal ID.
1745 If omitted or nil, the selected frame's display is used.  */)
1746      (display)
1747      Lisp_Object display;
1749   check_ns ();
1750   switch ([ns_get_window (display) backingType])
1751     {
1752     case NSBackingStoreBuffered:
1753       return Qt;
1755     case NSBackingStoreRetained:
1756     case NSBackingStoreNonretained:
1757       return Qnil;
1759     default:
1760       error ("Strange value for backingType parameter of frame");
1761     }
1762   return Qnil;  /* not reached, shut compiler up */
1766 DEFUN ("x-open-connection", Fx_open_connection, Sx_open_connection,
1767        1, 3, 0,
1768        doc: /* Open a connection to a Nextstep display server.
1769 DISPLAY is the name of the display to connect to.
1770 Optional arguments XRM-STRING and MUST-SUCCEED are currently ignored.  */)
1771      (display, resource_string, must_succeed)
1772      Lisp_Object display, resource_string, must_succeed;
1774   struct ns_display_info *dpyinfo;
1776   CHECK_STRING (display);
1778   nxatoms_of_nsselect ();
1779   dpyinfo = ns_term_init (display);
1780   if (dpyinfo == 0)
1781     {
1782       if (!NILP (must_succeed))
1783         fatal ("OpenStep on %s not responding.\n",
1784                SDATA (display));
1785       else
1786         error ("OpenStep on %s not responding.\n",
1787                SDATA (display));
1788     }
1790   /* Register our external input/output types, used for determining
1791      applicable services and also drag/drop eligibility. */
1792   ns_send_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1793   ns_return_types = [[NSArray arrayWithObject: NSStringPboardType] retain];
1794   ns_drag_types = [[NSArray arrayWithObjects:
1795                             NSStringPboardType,
1796                             NSTabularTextPboardType,
1797                             NSFilenamesPboardType,
1798                             NSURLPboardType,
1799                             NSColorPboardType,
1800                             NSFontPboardType, nil] retain];
1802   return Qnil;
1806 DEFUN ("x-close-connection", Fx_close_connection, Sx_close_connection,
1807        1, 1, 0,
1808        doc: /* Close the connection to the current Nextstep display server.
1809 The second argument DISPLAY is currently ignored.  */)
1810      (display)
1811      Lisp_Object display;
1813   check_ns ();
1814 #ifdef NS_IMPL_COCOA
1815   PSFlush ();
1816 #endif
1817   /*ns_delete_terminal (dpyinfo->terminal); */
1818   [NSApp terminate: NSApp];
1819   return Qnil;
1823 DEFUN ("x-display-list", Fx_display_list, Sx_display_list, 0, 0, 0,
1824        doc: /* Return the list of display names that Emacs has connections to.  */)
1825      ()
1827   Lisp_Object tail, result;
1829   result = Qnil;
1830   for (tail = ns_display_name_list; CONSP (tail); tail = XCDR (tail))
1831     result = Fcons (XCAR (XCAR (tail)), result);
1833   return result;
1837 DEFUN ("ns-hide-others", Fns_hide_others, Sns_hide_others,
1838        0, 0, 0,
1839        doc: /* Hides all applications other than emacs.  */)
1840      ()
1842   check_ns ();
1843   [NSApp hideOtherApplications: NSApp];
1844   return Qnil;
1847 DEFUN ("ns-hide-emacs", Fns_hide_emacs, Sns_hide_emacs,
1848        1, 1, 0,
1849        doc: /* If ON is non-nil, the entire emacs application is hidden.
1850 Otherwise if emacs is hidden, it is unhidden.
1851 If ON is equal to `activate', emacs is unhidden and becomes
1852 the active application.  */)
1853      (on)
1854      Lisp_Object on;
1856   check_ns ();
1857   if (EQ (on, intern ("activate")))
1858     {
1859       [NSApp unhide: NSApp];
1860       [NSApp activateIgnoringOtherApps: YES];
1861     }
1862   else if (NILP (on))
1863     [NSApp unhide: NSApp];
1864   else
1865     [NSApp hide: NSApp];
1866   return Qnil;
1870 DEFUN ("ns-emacs-info-panel", Fns_emacs_info_panel, Sns_emacs_info_panel,
1871        0, 0, 0,
1872        doc: /* Shows the 'Info' or 'About' panel for Emacs.  */)
1873      ()
1875   check_ns ();
1876   [NSApp orderFrontStandardAboutPanel: nil];
1877   return Qnil;
1881 DEFUN ("ns-font-name", Fns_font_name, Sns_font_name, 1, 1, 0,
1882        doc: /* Determine font postscript or family name for font NAME.
1883 NAME should be a string containing either the font name or an XLFD
1884 font descriptor.  If string contains `fontset' and not
1885 `fontset-startup', it is left alone. */)
1886      (name)
1887      Lisp_Object name;
1889   char *nm;
1890   CHECK_STRING (name);
1891   nm = SDATA (name);
1893   if (nm[0] != '-')
1894     return name;
1895   if (strstr (nm, "fontset") && !strstr (nm, "fontset-startup"))
1896     return name;
1898   return build_string (ns_xlfd_to_fontname (SDATA (name)));
1902 DEFUN ("ns-list-colors", Fns_list_colors, Sns_list_colors, 0, 1, 0,
1903        doc: /* Return a list of all available colors.
1904 The optional argument FRAME is currently ignored.  */)
1905      (frame)
1906      Lisp_Object frame;
1908   Lisp_Object list = Qnil;
1909   NSEnumerator *colorlists;
1910   NSColorList *clist;
1912   if (!NILP (frame))
1913     {
1914       CHECK_FRAME (frame);
1915       if (! FRAME_NS_P (XFRAME (frame)))
1916         error ("non-Nextstep frame used in `ns-list-colors'");
1917     }
1919   BLOCK_INPUT;
1921   colorlists = [[NSColorList availableColorLists] objectEnumerator];
1922   while (clist = [colorlists nextObject])
1923     {
1924       if ([[clist name] length] < 7 ||
1925           [[clist name] rangeOfString: @"PANTONE"].location == 0)
1926         {
1927           NSEnumerator *cnames = [[clist allKeys] reverseObjectEnumerator];
1928           NSString *cname;
1929           while (cname = [cnames nextObject])
1930             list = Fcons (build_string ([cname UTF8String]), list);
1931 /*           for (i = [[clist allKeys] count] - 1; i >= 0; i--)
1932                list = Fcons (build_string ([[[clist allKeys] objectAtIndex: i]
1933                                              UTF8String]), list); */
1934         }
1935     }
1937   UNBLOCK_INPUT;
1939   return list;
1943 DEFUN ("ns-list-services", Fns_list_services, Sns_list_services, 0, 0, 0,
1944        doc: /* List available Nextstep services by querying NSApp.  */)
1945      ()
1947   Lisp_Object ret = Qnil;
1948   NSMenu *svcs;
1949   id delegate;
1951   check_ns ();
1952   svcs = [[NSMenu alloc] initWithTitle: @"Services"];
1953   [NSApp setServicesMenu: svcs];  /* this and next rebuild on <10.4 */
1954   [NSApp registerServicesMenuSendTypes: ns_send_types
1955                            returnTypes: ns_return_types];
1957 /* On Tiger, services menu updating was made lazier (waits for user to
1958    actually click on the menu), so we have to force things along: */
1959 #ifdef NS_IMPL_COCOA
1960   if (NSAppKitVersionNumber >= 744.0)
1961     {
1962       delegate = [svcs delegate];
1963       if (delegate != nil)
1964         {
1965           if ([delegate respondsToSelector: @selector (menuNeedsUpdate:)])
1966               [delegate menuNeedsUpdate: svcs];
1967           if ([delegate respondsToSelector:
1968                             @selector (menu:updateItem:atIndex:shouldCancel:)])
1969             {
1970               int i, len = [delegate numberOfItemsInMenu: svcs];
1971               for (i =0; i<len; i++)
1972                   [svcs addItemWithTitle: @"" action: NULL keyEquivalent: @""];
1973               for (i =0; i<len; i++)
1974                   if (![delegate menu: svcs
1975                            updateItem: (NSMenuItem *)[svcs itemAtIndex: i]
1976                               atIndex: i shouldCancel: NO])
1977                     break;
1978             }
1979         }
1980     }
1981 #endif
1983   [svcs setAutoenablesItems: NO];
1984 #ifdef NS_IMPL_COCOA
1985   [svcs update]; /* on OS X, converts from '/' structure */
1986 #endif
1988   ret = interpret_services_menu (svcs, Qnil, ret);
1989   return ret;
1993 DEFUN ("ns-perform-service", Fns_perform_service, Sns_perform_service,
1994        2, 2, 0,
1995        doc: /* Perform Nextstep SERVICE on SEND.
1996 SEND should be either a string or nil.
1997 The return value is the result of the service, as string, or nil if
1998 there was no result.  */)
1999      (service, send)
2000      Lisp_Object service, send;
2002   id pb;
2003   NSString *svcName;
2004   char *utfStr;
2005   int len;
2007   CHECK_STRING (service);
2008   check_ns ();
2010   utfStr = SDATA (service);
2011   svcName = [NSString stringWithUTF8String: utfStr];
2013   pb =[NSPasteboard pasteboardWithUniqueName];
2014   ns_string_to_pasteboard (pb, send);
2016   if (NSPerformService (svcName, pb) == NO)
2017     Fsignal (Qquit, Fcons (build_string ("service not available"), Qnil));
2019   if ([[pb types] count] == 0)
2020     return build_string ("");
2021   return ns_string_from_pasteboard (pb);
2025 DEFUN ("ns-convert-utf8-nfd-to-nfc", Fns_convert_utf8_nfd_to_nfc,
2026        Sns_convert_utf8_nfd_to_nfc, 1, 1, 0,
2027        doc: /* Return an NFC string that matches  the UTF-8 NFD string STR.  */)
2028     (str)
2029     Lisp_Object str;
2031 /* TODO: If GNUstep ever implements precomposedStringWithCanonicalMapping,
2032          remove this. */
2033   NSString *utfStr;
2035   CHECK_STRING (str);
2036   utfStr = [NSString stringWithUTF8String: SDATA (str)];
2037   if (![utfStr respondsToSelector:
2038                  @selector (precomposedStringWithCanonicalMapping)])
2039     {
2040       message1
2041         ("Warning: ns-convert-utf8-nfd-to-nfc unsupported under GNUstep.\n");
2042       return Qnil;
2043     }
2044   else
2045     utfStr = [utfStr precomposedStringWithCanonicalMapping];
2046   return build_string ([utfStr UTF8String]);
2050 #ifdef NS_IMPL_COCOA
2052 /* Compile and execute the AppleScript SCRIPT and return the error
2053    status as function value.  A zero is returned if compilation and
2054    execution is successful, in which case *RESULT is set to a Lisp
2055    string or a number containing the resulting script value.  Otherwise,
2056    1 is returned. */
2057 static int
2058 ns_do_applescript (script, result)
2059      Lisp_Object script, *result;
2061   NSAppleEventDescriptor *desc;
2062   NSDictionary* errorDict;
2063   NSAppleEventDescriptor* returnDescriptor = NULL;
2065   NSAppleScript* scriptObject =
2066     [[NSAppleScript alloc] initWithSource:
2067                              [NSString stringWithUTF8String: SDATA (script)]];
2069   returnDescriptor = [scriptObject executeAndReturnError: &errorDict];
2070   [scriptObject release];
2071   
2072   *result = Qnil;
2073   
2074   if (returnDescriptor != NULL)
2075     {
2076       // successful execution
2077       if (kAENullEvent != [returnDescriptor descriptorType])
2078         {
2079           *result = Qt;
2080           // script returned an AppleScript result
2081           if ((typeUnicodeText == [returnDescriptor descriptorType]) ||
2082 #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
2083               (typeUTF16ExternalRepresentation 
2084                == [returnDescriptor descriptorType]) ||
2085 #endif
2086               (typeUTF8Text == [returnDescriptor descriptorType]) ||
2087               (typeCString == [returnDescriptor descriptorType]))
2088             {
2089               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2090               if (desc)
2091                 *result = build_string([[desc stringValue] UTF8String]);
2092             }
2093           else
2094             {
2095               /* use typeUTF16ExternalRepresentation? */
2096               // coerce the result to the appropriate ObjC type
2097               desc = [returnDescriptor coerceToDescriptorType: typeUTF8Text];
2098               if (desc)
2099                 *result = make_number([desc int32Value]);
2100             }
2101         }
2102     }
2103   else
2104     {
2105       // no script result, return error
2106       return 1;
2107     }
2108   return 0;
2111 DEFUN ("ns-do-applescript", Fns_do_applescript, Sns_do_applescript, 1, 1, 0,
2112        doc: /* Execute AppleScript SCRIPT and return the result.  If
2113 compilation and execution are successful, the resulting script value
2114 is returned as a string, a number or, in the case of other constructs,
2115 t.  In case the execution fails, an error is signaled. */)
2116     (script)
2117     Lisp_Object script;
2119   Lisp_Object result;
2120   long status;
2122   CHECK_STRING (script);
2123   check_ns ();
2125   BLOCK_INPUT;
2126   status = ns_do_applescript (script, &result);
2127   UNBLOCK_INPUT;
2128   if (status == 0)
2129     return result;
2130   else if (!STRINGP (result))
2131     error ("AppleScript error %d", status);
2132   else
2133     error ("%s", SDATA (result));
2135 #endif
2139 /* ==========================================================================
2141     Miscellaneous functions not called through hooks
2143    ========================================================================== */
2146 /* called from image.c */
2147 FRAME_PTR
2148 check_x_frame (Lisp_Object frame)
2150   return check_ns_frame (frame);
2154 /* called from frame.c */
2155 struct ns_display_info *
2156 check_x_display_info (Lisp_Object frame)
2158   return check_ns_display_info (frame);
2162 void
2163 x_set_scroll_bar_default_width (f)
2164      struct frame *f;
2166   int wid = FRAME_COLUMN_WIDTH (f);
2167   FRAME_CONFIG_SCROLL_BAR_WIDTH (f) = NS_SCROLL_BAR_WIDTH_DEFAULT;
2168   FRAME_CONFIG_SCROLL_BAR_COLS (f) = (FRAME_CONFIG_SCROLL_BAR_WIDTH (f) +
2169                                       wid - 1) / wid;
2173 /* terms impl this instead of x-get-resource directly */
2174 const char *
2175 x_get_string_resource (XrmDatabase rdb, char *name, char *class)
2177   /* remove appname prefix; TODO: allow for !="Emacs" */
2178   char *toCheck = class + (!strncmp (class, "Emacs.", 6) ? 6 : 0);
2179   const char *res;
2180   check_ns ();
2182   /* Support emacs-20-style face resources for backwards compatibility */
2183   if (!strncmp (toCheck, "Face", 4))
2184     toCheck = name + (!strncmp (name, "emacs.", 6) ? 6 : 0);
2186 /*fprintf (stderr, "Checking '%s'\n", toCheck); */
2187   
2188   res = [[[NSUserDefaults standardUserDefaults] objectForKey:
2189                    [NSString stringWithUTF8String: toCheck]] UTF8String];
2190   return !res ? NULL :
2191       (!strncasecmp (res, "YES", 3) ? "true" :
2192           (!strncasecmp (res, "NO", 2) ? "false" : res));
2196 Lisp_Object
2197 x_get_focus_frame (struct frame *frame)
2199   struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
2200   Lisp_Object nsfocus;
2202   if (!dpyinfo->x_focus_frame)
2203     return Qnil;
2205   XSETFRAME (nsfocus, dpyinfo->x_focus_frame);
2206   return nsfocus;
2211 x_pixel_width (struct frame *f)
2213   return FRAME_PIXEL_WIDTH (f);
2218 x_pixel_height (struct frame *f)
2220   return FRAME_PIXEL_HEIGHT (f);
2225 x_char_width (struct frame *f)
2227   return FRAME_COLUMN_WIDTH (f);
2232 x_char_height (struct frame *f)
2234   return FRAME_LINE_HEIGHT (f);
2239 x_screen_planes (struct frame *f)
2241   return FRAME_NS_DISPLAY_INFO (f)->n_planes;
2245 void
2246 x_sync (Lisp_Object frame)
2248   /* XXX Not implemented XXX */
2249   return;
2254 /* ==========================================================================
2256     Lisp definitions that, for whatever reason, we can't alias as 'ns-XXX'.
2258    ========================================================================== */
2261 DEFUN ("xw-color-defined-p", Fxw_color_defined_p, Sxw_color_defined_p, 1, 2, 0,
2262        doc: /* Return t if the current Nextstep display supports the color COLOR.
2263 The optional argument FRAME is currently ignored.  */)
2264      (color, frame)
2265      Lisp_Object color, frame;
2267   NSColor * col;
2268   check_ns ();
2269   return ns_lisp_to_color (color, &col) ? Qnil : Qt;
2273 DEFUN ("xw-color-values", Fxw_color_values, Sxw_color_values, 1, 2, 0,
2274        doc: /* Return a description of the color named COLOR.
2275 The value is a list of integer RGBA values--(RED GREEN BLUE ALPHA).
2276 These values appear to range from 0 to 65280; white is (65280 65280 65280 0).
2277 The optional argument FRAME is currently ignored.  */)
2278      (color, frame)
2279      Lisp_Object color, frame;
2281   NSColor * col;
2282   float red, green, blue, alpha;
2283   Lisp_Object rgba[4];
2285   check_ns ();
2286   CHECK_STRING (color);
2288   if (ns_lisp_to_color (color, &col))
2289     return Qnil;
2291   [[col colorUsingColorSpaceName: NSCalibratedRGBColorSpace]
2292         getRed: &red green: &green blue: &blue alpha: &alpha];
2293   rgba[0] = make_number (lrint (red*65280));
2294   rgba[1] = make_number (lrint (green*65280));
2295   rgba[2] = make_number (lrint (blue*65280));
2296   rgba[3] = make_number (lrint (alpha*65280));
2298   return Flist (4, rgba);
2302 DEFUN ("xw-display-color-p", Fxw_display_color_p, Sxw_display_color_p, 0, 1, 0,
2303        doc: /* Return t if the Nextstep display supports color.
2304 The optional argument DISPLAY specifies which display to ask about.
2305 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2306 If omitted or nil, that stands for the selected frame's display.  */)
2307      (display)
2308      Lisp_Object display;
2310   NSWindowDepth depth;
2311   NSString *colorSpace;
2312   check_ns ();
2313   depth = [ns_get_screen (display) depth];
2314   colorSpace = NSColorSpaceFromDepth (depth);
2316   return    [colorSpace isEqualToString: NSDeviceWhiteColorSpace]
2317          || [colorSpace isEqualToString: NSCalibratedWhiteColorSpace]
2318       ? Qnil : Qt;
2322 DEFUN ("x-display-grayscale-p", Fx_display_grayscale_p,
2323        Sx_display_grayscale_p, 0, 1, 0,
2324        doc: /* Return t if the Nextstep display supports shades of gray.
2325 Note that color displays do support shades of gray.
2326 The optional argument DISPLAY specifies which display to ask about.
2327 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2328 If omitted or nil, that stands for the selected frame's display. */)
2329      (display)
2330      Lisp_Object display;
2332   NSWindowDepth depth;
2333   check_ns ();
2334   depth = [ns_get_screen (display) depth];
2336   return NSBitsPerPixelFromDepth (depth) > 1 ? Qt : Qnil;
2340 DEFUN ("x-display-pixel-width", Fx_display_pixel_width, Sx_display_pixel_width,
2341        0, 1, 0,
2342        doc: /* Returns the width in pixels of the Nextstep display DISPLAY.
2343 The optional argument DISPLAY specifies which display to ask about.
2344 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2345 If omitted or nil, that stands for the selected frame's display.  */)
2346      (display)
2347      Lisp_Object display;
2349   check_ns ();
2350   return make_number ((int) [ns_get_screen (display) frame].size.width);
2354 DEFUN ("x-display-pixel-height", Fx_display_pixel_height,
2355        Sx_display_pixel_height, 0, 1, 0,
2356        doc: /* Returns the height in pixels of the Nextstep display DISPLAY.
2357 The optional argument DISPLAY specifies which display to ask about.
2358 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2359 If omitted or nil, that stands for the selected frame's display.  */)
2360      (display)
2361      Lisp_Object display;
2363   check_ns ();
2364   return make_number ((int) [ns_get_screen (display) frame].size.height);
2368 DEFUN ("display-usable-bounds", Fns_display_usable_bounds,
2369        Sns_display_usable_bounds, 0, 1, 0,
2370        doc: /*Return the bounds of the usable part of the screen.
2371 The return value is a list of integers (LEFT TOP WIDTH HEIGHT), which
2372 are the boundaries of the usable part of the screen, excluding areas
2373 reserved for the Mac menu, dock, and so forth.
2375 The screen queried corresponds to DISPLAY, which should be either a
2376 frame, a display name (a string), or terminal ID.  If omitted or nil,
2377 that stands for the selected frame's display. */)
2378      (display)
2379      Lisp_Object display;
2381   int top;
2382   NSRect vScreen;
2384   check_ns ();
2385   vScreen = [ns_get_screen (display) visibleFrame];
2386   top = vScreen.origin.y == 0.0 ?
2387     (int) [ns_get_screen (display) frame].size.height - vScreen.size.height : 0;
2389   return list4 (make_number ((int) vScreen.origin.x),
2390                 make_number (top),
2391                 make_number ((int) vScreen.size.width),
2392                 make_number ((int) vScreen.size.height));
2396 DEFUN ("x-display-planes", Fx_display_planes, Sx_display_planes,
2397        0, 1, 0,
2398        doc: /* Returns the number of bitplanes of the Nextstep display DISPLAY.
2399 The optional argument DISPLAY specifies which display to ask about.
2400 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2401 If omitted or nil, that stands for the selected frame's display.  */)
2402      (display)
2403      Lisp_Object display;
2405   check_ns ();
2406   return make_number
2407     (NSBitsPerSampleFromDepth ([ns_get_screen (display) depth]));
2411 DEFUN ("x-display-color-cells", Fx_display_color_cells,
2412        Sx_display_color_cells, 0, 1, 0,
2413        doc: /* Returns the number of color cells of the Nextstep display DISPLAY.
2414 The optional argument DISPLAY specifies which display to ask about.
2415 DISPLAY should be either a frame, a display name (a string), or terminal ID.
2416 If omitted or nil, that stands for the selected frame's display.  */)
2417      (display)
2418      Lisp_Object display;
2420   check_ns ();
2421   struct ns_display_info *dpyinfo = check_ns_display_info (display);
2423   /* We force 24+ bit depths to 24-bit to prevent an overflow.  */
2424   return make_number (1 << min (dpyinfo->n_planes, 24));
2428 /* Unused dummy def needed for compatibility. */
2429 Lisp_Object tip_frame;
2431 /* TODO: move to xdisp or similar */
2432 static void
2433 compute_tip_xy (f, parms, dx, dy, width, height, root_x, root_y)
2434      struct frame *f;
2435      Lisp_Object parms, dx, dy;
2436      int width, height;
2437      int *root_x, *root_y;
2439   Lisp_Object left, top;
2440   EmacsView *view = FRAME_NS_VIEW (f);
2441   NSPoint pt;
2442   
2443   /* Start with user-specified or mouse position.  */
2444   left = Fcdr (Fassq (Qleft, parms));
2445   if (INTEGERP (left))
2446     pt.x = XINT (left);
2447   else
2448     pt.x = last_mouse_motion_position.x;
2449   top = Fcdr (Fassq (Qtop, parms));
2450   if (INTEGERP (top))
2451     pt.y = XINT (top);
2452   else
2453     pt.y = last_mouse_motion_position.y;
2455   /* Convert to screen coordinates */
2456   pt = [view convertPoint: pt toView: nil];
2457   pt = [[view window] convertBaseToScreen: pt];
2459   /* Ensure in bounds.  (Note, screen origin = lower left.) */
2460   if (pt.x + XINT (dx) <= 0)
2461     *root_x = 0; /* Can happen for negative dx */
2462   else if (pt.x + XINT (dx) + width
2463            <= x_display_pixel_width (FRAME_NS_DISPLAY_INFO (f)))
2464     /* It fits to the right of the pointer.  */
2465     *root_x = pt.x + XINT (dx);
2466   else if (width + XINT (dx) <= pt.x)
2467     /* It fits to the left of the pointer.  */
2468     *root_x = pt.x - width - XINT (dx);
2469   else
2470     /* Put it left justified on the screen -- it ought to fit that way.  */
2471     *root_x = 0;
2473   if (pt.y - XINT (dy) - height >= 0)
2474     /* It fits below the pointer.  */
2475     *root_y = pt.y - height - XINT (dy);
2476   else if (pt.y + XINT (dy) + height
2477            <= x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)))
2478     /* It fits above the pointer */
2479       *root_y = pt.y + XINT (dy);
2480   else
2481     /* Put it on the top.  */
2482     *root_y = x_display_pixel_height (FRAME_NS_DISPLAY_INFO (f)) - height;
2486 DEFUN ("x-show-tip", Fx_show_tip, Sx_show_tip, 1, 6, 0,
2487        doc: /* Show STRING in a "tooltip" window on frame FRAME.
2488 A tooltip window is a small window displaying a string.
2490 FRAME nil or omitted means use the selected frame.
2492 PARMS is an optional list of frame parameters which can be used to
2493 change the tooltip's appearance.
2495 Automatically hide the tooltip after TIMEOUT seconds.  TIMEOUT nil
2496 means use the default timeout of 5 seconds.
2498 If the list of frame parameters PARMS contains a `left' parameter,
2499 the tooltip is displayed at that x-position.  Otherwise it is
2500 displayed at the mouse position, with offset DX added (default is 5 if
2501 DX isn't specified).  Likewise for the y-position; if a `top' frame
2502 parameter is specified, it determines the y-position of the tooltip
2503 window, otherwise it is displayed at the mouse position, with offset
2504 DY added (default is -10).
2506 A tooltip's maximum size is specified by `x-max-tooltip-size'.
2507 Text larger than the specified size is clipped.  */)
2508      (string, frame, parms, timeout, dx, dy)
2509      Lisp_Object string, frame, parms, timeout, dx, dy;
2511   int root_x, root_y;
2512   struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
2513   int count = SPECPDL_INDEX ();
2514   struct frame *f;
2515   char *str;
2516   NSSize size;
2518   specbind (Qinhibit_redisplay, Qt);
2520   GCPRO4 (string, parms, frame, timeout);
2522   CHECK_STRING (string);
2523   str = SDATA (string);
2524   f = check_x_frame (frame);
2525   if (NILP (timeout))
2526     timeout = make_number (5);
2527   else
2528     CHECK_NATNUM (timeout);
2530   if (NILP (dx))
2531     dx = make_number (5);
2532   else
2533     CHECK_NUMBER (dx);
2535   if (NILP (dy))
2536     dy = make_number (-10);
2537   else
2538     CHECK_NUMBER (dy);
2540   BLOCK_INPUT;
2541   if (ns_tooltip == nil)
2542     ns_tooltip = [[EmacsTooltip alloc] init];
2543   else
2544     Fx_hide_tip ();
2546   [ns_tooltip setText: str];
2547   size = [ns_tooltip frame].size;
2549   /* Move the tooltip window where the mouse pointer is.  Resize and
2550      show it.  */
2551   compute_tip_xy (f, parms, dx, dy, (int)size.width, (int)size.height,
2552                   &root_x, &root_y);
2554   [ns_tooltip showAtX: root_x Y: root_y for: XINT (timeout)];
2555   UNBLOCK_INPUT;
2557   UNGCPRO;
2558   return unbind_to (count, Qnil);
2562 DEFUN ("x-hide-tip", Fx_hide_tip, Sx_hide_tip, 0, 0, 0,
2563        doc: /* Hide the current tooltip window, if there is any.
2564 Value is t if tooltip was open, nil otherwise.  */)
2565      ()
2567   if (ns_tooltip == nil || ![ns_tooltip isActive])
2568     return Qnil;
2569   [ns_tooltip hide];
2570   return Qt;
2574 /* ==========================================================================
2576     Class implementations
2578    ========================================================================== */
2581 @implementation EmacsSavePanel
2582 #ifdef NS_IMPL_COCOA
2583 /* --------------------------------------------------------------------------
2584    These are overridden to intercept on OS X: ending panel restarts NSApp
2585    event loop if it is stopped.  Not sure if this is correct behavior,
2586    perhaps should check if running and if so send an appdefined.
2587    -------------------------------------------------------------------------- */
2588 - (void) ok: (id)sender
2590   [super ok: sender];
2591   panelOK = 1;
2592   [NSApp stop: self];
2594 - (void) cancel: (id)sender
2596   [super cancel: sender];
2597   [NSApp stop: self];
2599 #endif
2600 @end
2603 @implementation EmacsOpenPanel
2604 #ifdef NS_IMPL_COCOA
2605 /* --------------------------------------------------------------------------
2606    These are overridden to intercept on OS X: ending panel restarts NSApp
2607    event loop if it is stopped.  Not sure if this is correct behavior,
2608    perhaps should check if running and if so send an appdefined.
2609    -------------------------------------------------------------------------- */
2610 - (void) ok: (id)sender
2612   [super ok: sender];
2613   panelOK = 1;
2614   [NSApp stop: self];
2616 - (void) cancel: (id)sender
2618   [super cancel: sender];
2619   [NSApp stop: self];
2621 #endif
2622 @end
2625 @implementation EmacsFileDelegate
2626 /* --------------------------------------------------------------------------
2627    Delegate methods for Open/Save panels
2628    -------------------------------------------------------------------------- */
2629 - (BOOL)panel: (id)sender isValidFilename: (NSString *)filename
2631   return YES;
2633 - (BOOL)panel: (id)sender shouldShowFilename: (NSString *)filename
2635   return YES;
2637 - (NSString *)panel: (id)sender userEnteredFilename: (NSString *)filename
2638           confirmed: (BOOL)okFlag
2640   return filename;
2642 @end
2644 #endif
2646 /* ==========================================================================
2648     Lisp interface declaration
2650    ========================================================================== */
2653 void
2654 syms_of_nsfns ()
2656   int i;
2658   Qnone = intern ("none");
2659   staticpro (&Qnone);
2660   /* FIXME: Because of the typo below, Qbuffered probably never did
2661      anything useful, so it might as well be removed. */
2662   Qbuffered = intern ("bufferd");
2663   staticpro (&Qbuffered);
2664   Qfontsize = intern ("fontsize");
2665   staticpro (&Qfontsize);
2667   DEFVAR_LISP ("ns-icon-type-alist", &Vns_icon_type_alist,
2668                doc: /* Alist of elements (REGEXP . IMAGE) for images of icons associated to frames.
2669 If the title of a frame matches REGEXP, then IMAGE.tiff is
2670 selected as the image of the icon representing the frame when it's
2671 miniaturized.  If an element is t, then Emacs tries to select an icon
2672 based on the filetype of the visited file.
2674 The images have to be installed in a folder called English.lproj in the
2675 Emacs folder.  You have to restart Emacs after installing new icons.
2677 Example: Install an icon Gnus.tiff and execute the following code
2679   (setq ns-icon-type-alist
2680         (append ns-icon-type-alist
2681                 '((\"^\\\\*\\\\(Group\\\\*$\\\\|Summary \\\\|Article\\\\*$\\\\)\"
2682                    . \"Gnus\"))))
2684 When you miniaturize a Group, Summary or Article frame, Gnus.tiff will
2685 be used as the image of the icon representing the frame.  */);
2686   Vns_icon_type_alist = Fcons (Qt, Qnil);
2688   DEFVAR_LISP ("ns-version-string", &Vns_version_string,
2689                doc: /* Toolkit version for NS Windowing.  */);
2690   Vns_version_string = ns_appkit_version_str ();
2692   defsubr (&Sns_read_file_name);
2693   defsubr (&Sns_get_resource);
2694   defsubr (&Sns_set_resource);
2695   defsubr (&Sxw_display_color_p); /* this and next called directly by C code */
2696   defsubr (&Sx_display_grayscale_p);
2697   defsubr (&Sns_font_name);
2698   defsubr (&Sns_list_colors);
2699 #ifdef NS_IMPL_COCOA
2700   defsubr (&Sns_do_applescript);
2701 #endif
2702   defsubr (&Sxw_color_defined_p);
2703   defsubr (&Sxw_color_values);
2704   defsubr (&Sx_server_max_request_size);
2705   defsubr (&Sx_server_vendor);
2706   defsubr (&Sx_server_version);
2707   defsubr (&Sx_display_pixel_width);
2708   defsubr (&Sx_display_pixel_height);
2709   defsubr (&Sns_display_usable_bounds);
2710   defsubr (&Sx_display_mm_width);
2711   defsubr (&Sx_display_mm_height);
2712   defsubr (&Sx_display_screens);
2713   defsubr (&Sx_display_planes);
2714   defsubr (&Sx_display_color_cells);
2715   defsubr (&Sx_display_visual_class);
2716   defsubr (&Sx_display_backing_store);
2717   defsubr (&Sx_display_save_under);
2718   defsubr (&Sx_create_frame);
2719   defsubr (&Sns_set_alpha);
2720   defsubr (&Sx_open_connection);
2721   defsubr (&Sx_close_connection);
2722   defsubr (&Sx_display_list);
2724   defsubr (&Sns_hide_others);
2725   defsubr (&Sns_hide_emacs);
2726   defsubr (&Sns_emacs_info_panel);
2727   defsubr (&Sns_list_services);
2728   defsubr (&Sns_perform_service);
2729   defsubr (&Sns_convert_utf8_nfd_to_nfc);
2730   defsubr (&Sx_focus_frame);
2731   defsubr (&Sns_popup_prefs_panel);
2732   defsubr (&Sns_popup_font_panel);
2733   defsubr (&Sns_popup_color_panel);
2735   defsubr (&Sx_show_tip);
2736   defsubr (&Sx_hide_tip);
2738   /* used only in fontset.c */
2739   check_window_system_func = check_ns;
2743 // arch-tag: dc2a3f74-1123-4daa-8eed-fb78db6a5642